跳至主要内容

訂單簿

訂閱 Event Contract 訂單簿數據流,支持 25 檔行情。

推送頻率:20ms

Topic:
orderbook.25.{symbol},如 orderbook.25.ETHUSDT-28AUG26-2450-2570-OUT

快照/增量處理說明

訂閱成功後,首先收到 snapshot 全量數據。之後每次訂單簿變動,系統推送 delta 增量數據。若收到新的 snapshot,需重置本地訂單簿。

增量更新規則:

  • 收到 size = 0:刪除該條目
  • 收到不存在的條目:插入新條目
  • 收到已存在的條目:更新 size

返回參數

參數類型說明
topicstringTopic 名稱
typestring數據類型:snapshotdelta
tsnumber系統生成數據的時間戳(毫秒)
datamap對象
> sstring交易對名稱
> rarray賠付比率訂單簿條目,最多 25 檔
>> r[0]string賠付比率(價格)
>> r[1]string訂單金額(數量)。為 0 時表示該條目需刪除
> uinteger更新 ID。若 u=1,表示服務重啟後的快照,需重置本地訂單簿
> seqinteger跨業務序號,seq 越小說明數據越早生成
ctsnumber撮合引擎生成此數據的時間戳

訂閱示例

{
"op": "subscribe",
"args": [
"orderbook.25.ETHUSDT-28AUG26-2450-2570-OUT"
]
}

推送示例

{
"topic": "orderbook.25.ETHUSDT-28AUG26-2450-2570-OUT",
"ts": 1787794783020,
"type": "snapshot",
"data": {
"s": "ETHUSDT-28AUG26-2450-2570-OUT",
"r": [
["3.5", "14900"],
["2.28", "500"],
["2.07", "500"]
],
"u": 702,
"seq": 49115
},
"cts": 1787794647814
}