跳至主要内容

推送報文格式

每一幀推送都是統一信封 {ch, event, data}:

  • ch — 頻道族名。它是分發鍵:同一 ch 始終承載同一 data 形狀。按 ch 分發你的 handler。

  • event — 歸一後的訂閱串(<type>@<symbol>,如 deal@btc_usdt)。用 event 把一幀對回自己的訂閱。

  • 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
}
}