行情

K 線訂閱

WS推送 · cmd 105

訂閱的標的的實時 K 線數據推送。回調在當前 K 線更新時觸發(Realtime 模式)或在一根 K 線週期結束時觸發(Confirmed 模式)。

Tip

本頁介紹的是推送 API(subscribe_candlesticks)。如需按需拉取歷史 K 線數據,請參見 K 線 - 拉取。

message PushCandlestick {
  string symbol = 1;
  Period period = 2;
  Candlestick candlestick = 3;
}
行情權限要求免費
  • 美股:預設免費贈送 US LV1 實時行情。
  • 港股:預設贈送 LV1 實時行情。
  • K 線推送所需權限與訂閱行情相同。

推送欄位

名稱類型必填說明
symbolstring可選標的代碼,例如:AAPL.US
periodint32可選K 線週期,詳見 Period
candlestickobject可選K 線數據
└ closestring可選收盤價
└ openstring可選開盤價
└ highstring可選最高價
└ lowstring可選最低價
└ volumeint64可選成交量
└ turnoverstring可選成交額
└ timestampint64可選K 線時間(Unix 時間戳)
└ trade_sessionint32可選交易時段,詳見 TradeSession

響應 JSON 示例

{
  "symbol": "700.HK",
  "period": 1,
  "candlestick": {
    "close": "162.500",
    "open": "160.000",
    "high": "163.000",
    "low": "159.800",
    "volume": 123456,
    "turnover": "19987654.000",
    "timestamp": 1651103700,
    "trade_session": 0
  }
}