K线订阅

订阅合约实时 K线数据推送。

订阅格式

{symbol}@kline_{interval} (例如: BTCUSD@kline_1m)

支持的时间周期

1m, 5m, 15m, 30m, 1h, 2h, 4h, 1d, 1w, 1mo

订阅请求

可以同时订阅多个合约和周期

{
  "action": "subscribe",
  "streams": [
    "BTCUSD@kline_1m",
    "ETHUSD@kline_5m"
  ]
}

推送数据字段

字段	类型	说明
event	string	事件类型: data
channel	string	频道: kline
data.symbol	string	合约标识
data.interval	string	K线周期
data.t	int64	K线开盘时间戳（毫秒）
data.o	string	开盘价
data.h	string	最高价
data.l	string	最低价
data.c	string	收盘价（当前K线最新价）
data.v	string	成交量
data.isClosed	bool	K线是否已收盘（true=已收盘，false=进行中）
time	int64	推送时间戳（毫秒）

推送示例

{
  "event": "data",
  "channel": "kline",
  "data": {
    "symbol": "BTCUSD",
    "interval": "1m",
    "t": 1736163000000,
    "o": "50000.00",
    "h": "50150.00",
    "l": "49980.00",
    "c": "50120.00",
    "v": "1000000",
    "isClosed": false
  },
  "time": 1736163000000
}

取消订阅

{
  "action": "unsubscribe",
  "streams": ["BTCUSD@kline_1m"]
}