跳到主要内容
版本:Next (V2.0)

MiniTicker 全量推送

订阅所有合约交易对的 24 小时精简行情,每 3000ms 推送一次全量快照。

连接成功(欢迎消息)

连接建立后,服务端主动推送一条欢迎消息:

{
"event": "connected",
"message": "合约行情WebSocket连接成功",
"timestamp": 1719290000000,
"data": {
"clientId": "abc123",
"supportChannels": ["order_book", "ticker", "book_ticker", "kline", "miniTickerArr", "markPrice"],
"streamFormat": "SYMBOL@CHANNEL (例如: BTCUSDT@order_book20, BTCUSDT@kline_1m, BTCUSDT@markPrice) 或 !miniTicker@arr@3000ms"
}
}

订阅格式

!miniTicker@arr@3000ms

订阅请求

{
"action": "subscribe",
"streams": ["!miniTicker@arr@3000ms"]
}

订阅成功响应

{
"event": "subscribed",
"message": "订阅成功",
"timestamp": 1719290000000,
"data": {
"streams": ["!miniTicker@arr@3000ms"]
}
}
字段类型说明
eventstring固定为 subscribed
messagestring提示信息
timestampint64时间戳(毫秒)
data.streamsstring[]本次成功订阅的 stream 列表

推送数据

外层字段

字段类型说明
eventstring固定为 data
streamstring固定为 !miniTicker@arr@3000ms
channelstring固定为 miniTickerArr
timestampint64推送时间戳(毫秒)
dataarrayMiniTickerItem 数组,包含所有交易对

data[] 单条字段

字段类型说明
sstring交易对,如 BTCUSDT
cstring最新价(收盘价)
ostring开盘价
hstring24h 最高价
lstring24h 最低价
vstring24h 成交量
Pstring涨跌幅 %,保留 4 位小数
Eint64本条数据时间戳(毫秒)

推送示例

{
"event": "data",
"stream": "!miniTicker@arr@3000ms",
"channel": "miniTickerArr",
"timestamp": 1719290000000,
"data": [
{
"s": "BTCUSDT",
"c": "65000.00",
"o": "63000.00",
"h": "66000.00",
"l": "62000.00",
"v": "1234.5678",
"P": "3.1746",
"E": 1719290000000
}
]
}

取消订阅

取消订阅请求

{
"action": "unsubscribe",
"streams": ["!miniTicker@arr@3000ms"]
}

取消订阅响应

{
"event": "unsubscribed",
"message": "取消订阅成功",
"timestamp": 1719290000000,
"data": {
"streams": ["!miniTicker@arr@3000ms"]
}
}