# 实时盘口订阅

`WS` `push · cmd 102`

> **行情权限要求 · 免费**
> 美股：默认免费赠送 US LV1 一档买卖盘报价（含盘前、盘中、盘后、夜盘全时段）。
> 港股：默认赠送 LV1 一档买卖盘报价；十档买卖盘需购买「LV2 高级行情 - Plus (OpenAPI)」行情卡。
> 美股期权：默认无权限，需购买「OPRA 美股期权行情 (OpenAPI)」行情卡。
> _OpenAPI 行情权限独立于 App/Web 行情权限_

已订阅标的的实时盘口数据推送。

```protobuf
message PushDepth {
  string symbol = 1;
  int64 sequence = 2;
  repeated Depth ask = 3;
  repeated Depth bid = 4;
}
```

## Push Fields

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | No | 标的代码，例如：AAPL.US |
| `sequence` | int64 | No | 序列号 |
| `ask` | object[] | No | 卖盘 |
| `└ position` | int32 | No | 档位 |
| `└ price` | string | No | 价格 |
| `└ volume` | int64 | No | 挂单量 |
| `└ order_num` | int64 | No | 订单数量 |
| `bid` | object[] | No | 买盘 |
| `└ position` | int32 | No | 档位 |
| `└ price` | string | No | 价格 |
| `└ volume` | int64 | No | 挂单量 |
| `└ order_num` | int64 | No | 订单数量 |

## Response JSON Example

```json
{
  "symbol": "700.HK",
  "sequence": 160808750000000,
  "ask": [
    {
      "position": 1,
      "price": "335.000",
      "volume": 500,
      "order_num": 1
    }
  ],
  "bid": [
    {
      "position": 1,
      "price": "334.800",
      "volume": 69400,
      "order_num": 13
    }
  ]
}
```
