跳到主要内容

推送报文格式

每一帧推送都是统一信封 {ch, event, data}:

  • ch —— 频道族名。它是分发键:同一 ch 恒携带同一 data 结构。请按 ch 分发 handler。

  • event —— 归一后的订阅串(<type>@<symbol>,如 deal@btc_usdt)。据此把帧对回自己的订阅。

  • data —— 载荷。单 symbol 频道为对象,批量频道(tickers、pred_tickers)为数组。字段一律短键;仅出现非 null 字段。

注意:全深度族的 ch 为 depth_update(data 内带 type = snapshot/delta 字段),定档深度族的 ch 为 depth。K线族的 ch 为 kline(族名,不带周期——周期在 event 与 data.i)。

格式

{
"ch": "deal", //频道族(分发键)
"event": "deal@btc_usdt", //归一订阅串
"data": {
"s": "btc_usdt", //symbol
"p": "43000", //价格
"a": "0.21", //数量(base)
"m": "BID", //taker方向: BID或ASK
"t": 1655992403617 //时间
}
}

成交记录(实时推送报文)样例

{
"ch": "deal",
"event": "deal@btc_usdt",
"data": {
"s": "btc_usdt",
"p": "43000",
"a": "0.21",
"m": "BID",
"t": 1655992403617
}
}