行情

实时 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
  }
}