跳到主要内容

OSS L1 快照

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

订阅市场的最优买价/最优卖价(Level 1)。 主题格式: snapshotL1:<symbol>(例如 snapshotL1:BTC-PERP)

每条消息都是当前最优买/卖价的完整快照。bids 和 asks 数组各包含一个 [价格, 数量] 元组,代表订单簿的最优档位,type 字段始终为 snapshotL1。

买卖报价以字符串形式的 price 和 size 元组发送,以保持精度; 客户端应使用高精度类型(如 BigDecimal、decimal.js)解析后再进行运算。

由于每次推送都是完整快照,客户端只需在收到消息时覆盖本地副本即可—— 无序列号,无需增量合并。如果连接断开,请重新订阅该主题以恢复接收更新。

响应内容​

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

Data 对象:

名称类型是否必填描述
bidsString[][]是最优买价 [价格, 数量]
asksString[][]是最优卖价 [价格, 数量]
symbolString是市场交易对
typeString是始终为 snapshotL1
timestampLong是订单簿时间戳(毫秒)
example

Request

{
"op": "subscribe",
"args": [
"snapshotL1:BTC-PERP"
]
}

Request

{
"op": "unsubscribe",
"args": [
"snapshotL1:BTC-PERP"
]
}

Response

{
"topic": "snapshotL1:BTC-PERP",
"data": {
"bids": [
[
"122160.1",
"69350"
]
],
"asks": [
[
"122133.3",
"1000"
]
],
"type": "snapshotL1",
"symbol": "BTC-PERP",
"timestamp": 1565135165600
}
}