深度频道
功能说明
推送指定交易对在指定档位的订单簿变更(depth)。订阅成功后会先下发一次快照(SNAPSHOT),随后推送增量更新(CHANGED)。
订阅请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| method | String | 是 | SUBSCRIBE 订阅,UNSUBSCRIBE 取消订阅。 |
| params | Array<String> | 是 | <symbol>@depth{level},支持档位:15、200,例如 BTCUSDT@depth15。 |
| id | Number | 否 | 客户端自定义标识,在回执中原样返回。 |
订阅示例
{
"method": "SUBSCRIBE",
"params": [
"BTCUSDT@depth15"
],
"id": 2
}
回执示例
| 字段 | 类型 | 说明 |
|---|---|---|
| result | Boolean | true 表示操作成功,false 表示失败。 |
| id | Number | 返回请求中的 id。 |
| msg | String | 当 result 为 false 时返回错误信息。 |
回执示例
{
"result": true,
"id": 2
}
推送数据 (depth)
| 字段 | 类型 | 说明 |
|---|---|---|
| e | String | 事件类型,depth。 |
| E | Number | 事件时间(毫秒)。 |
| s | String | 交易对(大写)。 |
| U | Number | 本消息中的首个更新 ID。 |
| u | Number | 本消息中的最后一个更新 ID。 |
| l | Number | 深度档位(15 或 200)。 |
| d | String | 深度类型,SNAPSHOT 或 CHANGED。 |
| b | Array<Array<String>> | 买盘更新,格式 [价格, 数量]。 |
| a | Array<Array<String>> | 卖盘更新,格式 [价格, 数量]。 |
| f | String | 合并深度因子(仅在开启合并时返回)。 |
推送示例
{
"e": "depth",
"E": 1773295701456,
"s": "BTCUSDT",
"U": 161,
"u": 161,
"l": 15,
"d": "CHANGED",
"b": [
["103435.90", "2.10000"]
],
"a": [
["103436.10", "1.21500"]
]
}
处理建议: 按照更新 ID 顺序依次消费(
U至u)。若发现更新丢失,请重新订阅获取最新快照。