订单簿增量更新
WSProduction
wss://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。如果出现断档,请取消订阅并重新订阅- 如果订单簿交叉(最优买价 >= 最优卖价),请取消订阅并重新订阅
响应内容
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| topic | String | 是 | WebSocket 主题 |
| data | Object | 是 | 数据对象 |
Data 对象:
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| bids | String[][] | 是 | 买单更新 [价格, 数量] |
| asks | String[][] | 是 | 卖单更新 [价格, 数量] |
| seqNum | Integer | 是 | 当前序列号 |
| prevSeqNum | Integer | 是 | 上一个序列号 |
| type | String | 是 | snapshot(首次)或 delta(增量更新) |
| timestamp | Long | 是 | 订单簿时间戳 |
| symbol | String | 是 | 市场交易对 |
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"
}
}