跳到主要内容

订单簿增量更新

WSProductionwss://ws.btse.com/ws/oss/futuresTestnetwss://testws.btse.io/ws/oss/futures

订阅完整订单簿更新,支持增量推送。 主题格式: update:<symbol>_<grouping>(例如 update:BTC-PERP_0

订阅成功后,服务器会先推送一条 snapshot(最多 50 档),随后推送 delta 增量更新。 snapshot 不应用任何分组(即原始订单簿);仅 delta 更新会按订阅的 <grouping> 值聚合。 若市场处于无成交的静默状态,仍会收到 snapshot;在订单簿活动恢复前不会有 delta。

应用增量更新:

  • [price, size] 元组:如果 size"0",则删除该价位;否则更新该价位
  • seqNum 必须等于 prevSeqNum + 1。如果出现断档,请取消订阅并重新订阅
  • 如果订单簿交叉(最优买价 >= 最优卖价),请取消订阅并重新订阅

响应内容

名称类型是否必填描述
topicStringWebSocket 主题
dataObject数据对象

Data 对象:

名称类型是否必填描述
bidsString[][]买单更新 [价格, 数量]
asksString[][]卖单更新 [价格, 数量]
seqNumInteger当前序列号
prevSeqNumInteger上一个序列号
typeStringsnapshot(首次)或 delta(增量更新)
timestampLong订单簿时间戳
symbolString市场交易对
example

Response

{
"topic": "update:BTC-PERP_0",
"data": {
"bids": [
[
"122160.1",
"69350"
],
[
"122159.9",
"226150"
]
],
"asks": [
[
"122133.3",
"1000"
],
[
"122124.0",
"343410"
]
],
"seqNum": 628282,
"prevSeqNum": 628281,
"type": "snapshot",
"timestamp": 1565135165600,
"symbol": "BTC-PERP"
}
}