> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rails.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Open Orders Stream

This stream provides your open orders. Subscribe with the `optionsOpenOrders`
subscription, then request a snapshot with `emitOptionsOpenOrders`. Changes arrive as
`optionsOpenOrdersDelta` messages.

### Open Orders Snapshot Request

#### Request

```json theme={null}
{
  "message": "emitOptionsOpenOrders",
  "content": {
    "clientRequestId": "90b20400-0c28-4f03-b2e4-d19e881ece31",
    "market": "BTC-10JUL26-55000-C"
  }
}
```

| Field                     | Type   | Required | Description                                          |
| ------------------------- | ------ | -------- | ---------------------------------------------------- |
| `message`                 | string | Yes      | `emitOptionsOpenOrders`                              |
| `content.clientRequestId` | string | No       | Client-generated UUID for correlation                |
| `content.market`          | string | No       | A contract name to filter, or `ALL` for every market |
| `content.pageSize`        | number | No       | Page size for paginated results                      |
| `content.pageToken`       | string | No       | Cursor for the next page                             |

#### Response

```json theme={null}
{
  "resultType": "optionsOpenOrders",
  "market": "BTC-10JUL26-55000-C",
  "data": {
    "orders": [
      {
        "orderId": "01KWKXG9J8RNYDKXCWYZPBEW4C",
        "market": "BTC-10JUL26-55000-C",
        "side": "buy",
        "type": "limit",
        "initiatorType": "user",
        "price": "6700",
        "quantity": "1",
        "filledQuantity": "0",
        "leverage": "0",
        "reduceOnly": false,
        "postOnly": false,
        "createdAt": 1783079904841,
        "updatedAt": 1783079904841
      }
    ],
    "statusCode": 200,
    "clientRequestId": "90b20400-0c28-4f03-b2e4-d19e881ece31"
  }
}
```

| Field                                   | Type    | Required | Description                           |
| --------------------------------------- | ------- | -------- | ------------------------------------- |
| `resultType`                            | string  | Yes      | `optionsOpenOrders`                   |
| `market`                                | string  | Yes      | Contract name                         |
| `data.orders[].orderId`                 | string  | Yes      | Order identifier                      |
| `data.orders[].market`                  | string  | Yes      | Contract name                         |
| `data.orders[].side`                    | string  | Yes      | `buy` or `sell`                       |
| `data.orders[].type`                    | string  | Yes      | Order type: `limit` or `market`       |
| `data.orders[].initiatorType`           | string  | Yes      | Who created the order, e.g. `user`    |
| `data.orders[].price`                   | string  | Yes      | Order price                           |
| `data.orders[].quantity`                | string  | Yes      | Order quantity                        |
| `data.orders[].filledQuantity`          | string  | Yes      | Quantity filled so far                |
| `data.orders[].leverage`                | string  | Yes      | Leverage — always `0` for options     |
| `data.orders[].reduceOnly`              | boolean | Yes      | Reduce-only flag                      |
| `data.orders[].postOnly`                | boolean | Yes      | Maker-only flag                       |
| `data.orders[].createdAt` / `updatedAt` | number  | Yes      | Timestamps (ms since epoch)           |
| `data.statusCode`                       | number  | Yes      | `200`                                 |
| `data.clientRequestId`                  | string  | No       | Client-generated UUID for correlation |

### Open Order Updates

`optionsOpenOrdersDelta` messages carry incremental changes. Each order includes a `kind`
field describing the change:

| `kind` | Meaning                                           |
| ------ | ------------------------------------------------- |
| `add`  | A new open order                                  |
| `drop` | The order is no longer open (filled or cancelled) |