推送报文格式
每一帧推送都是统一信封 {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
}
}