# 價格訂閱

`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
}
```
