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

# bbos

> Subscribe to best bid and offer (BBO) updates for all symbols via WebSocket, pushed every second.

Push interval: 1s

```json theme={null}
{
  "id": "clientID5",
  "topic": "bbos",
  "event": "subscribe"
}
```

**Parameters**

| Name  | Type   | Required | Description               |
| ----- | ------ | -------- | ------------------------- |
| id    | string | Y        | id generate by client     |
| event | string | Y        | `subscribe`/`unsubscribe` |
| topic | string | Y        | `bbos`                    |

<RequestExample>
  ```json Response theme={null}
  {
    "id": "clientID5",
    "event": "subscribe",
    "success": true,
    "ts": 1609924478533
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Subscribed Message theme={null}
  {
      "topic":"bbos",
      "ts":1618822376000,
      "data":[
          {
              "symbol":"PERP_NEAR_USDC",
              "ask":15.0318,
              "askSize":370.43,
              "bid":15.9158,
              "bidSize":16
          },
          {
              "symbol":"PERP_WOO_USDC",
              "ask":0.318,
              "askSize":300.163881,
              "bid":0.3179,
              "bidSize":500.941728
          },
         ...
      ]
  }
  ```
</ResponseExample>
