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

# Balance

> Subscribe to real-time token balance updates via private WebSocket stream.

Push interval: real-time push

```json theme={null}
{
  "id": "clientID3",
  "topic": "balance",
  "event": "subscribe"
}
```

**Parameters**

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

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

<ResponseExample>
  ```json Subscribed Message theme={null}
  {
      "topic":"balance",
      "ts":1651836695254,
      "data":{
          "balances":{
              "USDC":{
                  "holding":5555815.47398272,
                  "frozen":0,
                  "interest":0,
                  "pendingShortQty":0,
                  "pendingExposure":0,
                  "pendingLongQty":0,
                  "pendingLongExposure":0,
                  "isolatedMargin": 100,
                  "isolatedOrderFrozen": 100,
                  "version":894,
                  "staked":51370692,
                  "unbonding":0,
                  "vault":0,
                  "averageOpenPrice":0.00000574,
                  "pnl24H":0,
                  "fee24H":0.01914,
                  "markPrice":0.31885
              }
          }
      }
  }
  ```
</ResponseExample>