> ## 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.

# Request orderbook

> Request a one-time orderbook snapshot for a symbol via WebSocket instead of subscribing to updates.

## Request orderbook

```json theme={null}
{
  "id": "clientID2",
  "topic": "PERP_NEAR_USDC@orderbookupdate",
  "event": "subscribe"
}
```

**Parameters**

| Name          | Type   | Required | Description            |
| ------------- | ------ | -------- | ---------------------- |
| id            | string | Y        | id generated by client |
| event         | string | Y        | request                |
| params.type   | string | Y        | orderbook              |
| params.symbol | string | Y        | `{symbol}`             |

<RequestExample>
  ```json Response theme={null}
  {
    "id": "clientID1",
    "event": "request",
    "params": {
      "type": "orderbook",
      "symbol": "PERP_NEAR_USDC"
    }
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Subscribed Message theme={null}
  {
      "id":"123r",
      "event":"request",
      "success":true,
      "ts":1618880432419,
      "data":{
          "symbol":"PERP_NEAR_USDC",
          "ts":1618880432380,
          "asks":[
              [
                  15,
                  0.443951
              ],
              [
                  15.02,
                  0.002566
              ],
              ...
          ],
          "bids":[
              [
                  14.99,
                  2.887466
              ],
              [
                  14.76,
                  2.034711
              ],
             ...
          ]
      }
  }
  ```
</ResponseExample>