跳到主要内容

OSS L1 快照

WSProductionwss://ws.btse.com/ws/oss/spotTestnetwss://testws.btse.io/ws/oss/spot

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

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

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

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

响应内容

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

Data 对象:

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

Request

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

Request

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

Response

{
"topic": "snapshotL1:BTC-USD",
"data": {
"bids": [
[
"28016.7",
"1.48063"
]
],
"asks": [
[
"28033.6",
"1.34133"
]
],
"type": "snapshotL1",
"symbol": "BTC-USD",
"timestamp": 1680750154232
}
}