OSS L1 快照
WSProduction
wss://ws.btse.com/ws/oss/spotTestnetwss://testws.btse.io/ws/oss/spot订阅市场的最优买价/最优卖价(Level 1)。
主题格式: snapshotL1:<symbol>(例如 snapshotL1:BTC-USD)
每条消息都是当前最优买/卖价的完整快照。bids 和 asks 数组各包含一个
[价格, 数量] 元组,代表订单簿的最优档位,type 字段始终为 snapshotL1。
买卖报价以字符串形式的 price 和 size 元组发送,以保持精度;
客户端应使用高精度类型(如 BigDecimal、decimal.js)解析后再进行运算。
由于每次推送都是完整快照,客户端只需在收到消息时覆盖本地副本即可—— 无序列号,无需增量合并。如果连接断开,请重新订阅该主题以恢复接收更新。
响应内容
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| topic | String | 是 | WebSocket 主题 |
| data | Object | 是 | 数据对象 |
Data 对象:
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| bids | String[][] | 是 | 最优买价 [价格, 数量] |
| asks | String[][] | 是 | 最优卖价 [价格, 数量] |
| symbol | String | 是 | 市场交易对 |
| type | String | 是 | 始终为 snapshotL1 |
| timestamp | Long | 是 | 订单簿时间戳(毫秒) |
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
}
}