# 实时价格订阅

`WS` `push · cmd 101`

> **行情权限要求 · 免费**
> 美股：默认免费赠送 US LV1 实时行情（含盘前、盘中、盘后、夜盘全时段）；夜盘数据需设置 LONGBRIDGE_ENABLE_OVERNIGHT=true 开启（详见 Broker FAQ Q6、Q7）。
> 港股：默认赠送 LV1 实时行情。
> 美股期权：默认无权限，需购买「OPRA 美股期权行情 (OpenAPI)」行情卡。
> _OpenAPI 行情权限独立于 App/Web 行情权限_

已订阅标的的实时价格订阅，推送的数据结构中，只有有变化的字段才会填充数据。

```protobuf
message PushQuote {
  string symbol = 1;
  int64 sequence = 2;
  string last_done = 3;
  string open = 4;
  string high = 5;
  string low = 6;
  int64 timestamp = 7;
  int64 volume = 8;
  string turnover = 9;
  TradeStatus trade_status = 10;
  TradeSession trade_session = 11;
}
```

## Push Fields

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | No | 标的代码，例如：AAPL.US |
| `sequence` | int64 | No | 序列号 |
| `last_done` | string | No | 最新价 |
| `open` | string | No | 开盘价 |
| `high` | string | No | 最高价 |
| `low` | string | No | 最低价 |
| `timestamp` | int64 | No | 最新成交的时间戳 |
| `volume` | int64 | No | 成交量 |
| `turnover` | string | No | 成交额 |
| `trade_status` | int32 | No | 交易状态，详见 TradeStatus |
| `trade_session` | int32 | No | 交易时段，详见 TradeSession |
| `current_volume` | int32 | No | 两次推送之间增加的成交量 |
| `current_turnover` | string | No | 两次推送之间增加的成交额 |
| `tag` | int32 | No | 价格数据标签：0 实时行情，1 收盘后的修正数据 |

## Response JSON Example

```json
{
  "symbol": "AAPL.US",
  "sequence": 160808750000000,
  "last_done": "156.570",
  "open": "155.910",
  "high": "159.790",
  "low": "155.380",
  "timestamp": 1651089600,
  "volume": 88063191,
  "turnover": "13865092584.000",
  "trade_status": 0,
  "trade_session": 0
}
```
