K线频道

描述

推送指定交易对的 K 线（蜡烛图）数据。订阅成功后，服务端以事件类型 kline 实时推送对应周期与价格类型的更新。

订阅请求参数

参数名	类型	是否必须	说明
method	String	是	SUBSCRIBE 订阅，UNSUBSCRIBE 取消订阅。
params	Array<String>	是	<symbol>@kline_<interval>_<priceType>，例如 BTCUSDT@kline_1m_LAST_PRICE。
id	Number	否	客户端自定义 ID，用于匹配回执。

interval 取值（区分大小写）

token	说明
1m	1 分钟
5m	5 分钟
15m	15 分钟
30m	30 分钟
1h	1 小时
2h	2 小时
4h	4 小时
6h	6 小时
8h	8 小时
12h	12 小时
1d	1 天
1w	1 周
1M	1 个自然月（大写 M）

priceType 取值

token	说明
LAST_PRICE	最新价 K 线
MARK_PRICE	标记价 K 线

订阅请求示例

{
  "method": "SUBSCRIBE",
  "params": [
    "ETHUSDT@kline_1m_LAST_PRICE"
  ],
  "id": 4
}

订阅回执

字段	类型	说明
result	Boolean	true 表示成功，false 表示失败。
id	Number	返回请求中的 id。
msg	String	失败时的错误信息。

回执示例

{
  "result": true,
  "id": 4
}

推送字段说明（kline）

字段	类型	说明
e	String	事件类型，固定为 kline。
E	Number	事件时间（毫秒）。
s	String	交易对（大写）。
p	String	价格类型（如 LAST_PRICE）。
d	Array<Object>	K 线数组，通常只包含正在更新的最新一根。
> t	Number	K 线开始时间（毫秒）。
> T	Number	K 线结束时间（毫秒）。
> s	String	交易对。
> i	String	订阅时使用的周期 token（如 1m）。
> o	String	开盘价。
> c	String	收盘价。
> h	String	最高价。
> l	String	最低价。
> v	String	成交量（基础币）。
> n	Number	成交笔数。
> q	String	成交额（计价币）。
> V	String	主动买入成交量。
> Q	String	主动买入成交额。

推送示例

{
  "e": "kline",
  "E": 1773295738000,
  "s": "ETHUSDT",
  "p": "LAST_PRICE",
  "d": [
    {
      "t": 1773295680000,
      "T": 1773295739999,
      "s": "ETHUSDT",
      "i": "1m",
      "o": "3572.10",
      "c": "3573.40",
      "h": "3574.00",
      "l": "3571.80",
      "v": "18.2",
      "n": 9,
      "q": "65035.88",
      "V": "9.4",
      "Q": "33590.96"
    }
  ]
}

提示： 周期 token 区分大小写，例如 1m 表示分钟线，1M 表示月线；价格类型建议使用大写以避免校验失败。