K 线频道
功能说明
推送指定交易对在特定周期和价格类型下的 K 线数据。每次推送包含最新一根(正在生成)的 K 线。
订阅请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| method | String | 是 | SUBSCRIBE 订阅,UNSUBSCRIBE 退订。 |
| params | Array<String> | 是 | <symbol>@kline_<interval>_<priceType>,如 ETHUSDT@kline_1m_LAST_PRICE。 |
| id | Number | 否 | 客户端自定义标识,在回执中原样返回。 |
周期参数(interval)
| 取值 | 说明 |
|---|---|
| 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)
| 取值 | 说明 |
|---|---|
| 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 为 false 时返回错误信息。 |
回执示例
{
"result": true,
"id": 4
}
推送数据 (kline)
| 字段 | 类型 | 说明 |
|---|---|---|
| e | String | 事件类型,kline。 |
| E | Number | 事件时间(毫秒)。 |
| s | String | 交易对。 |
| p | String | 价格类型(LAST_PRICE、MARK_PRICE)。 |
| d | Array<Object> | K 线明细列表。 |
| > t | Number | K 线开始时间(毫秒)。 |
| > T | Number | K 线结束时间(毫秒)。 |
| > s | String | 交易对。 |
| > i | String | 周期标识(与订阅参数一致)。 |
| > 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"
}
]
}
注意: 周期参数区分大小写,
1m与1M含义不同。