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"]
}
}
| 字段 | 类型 | 说明 |
|---|---|---|
| event | string | 固定为 subscribed |
| message | string | 提示信息 |
| timestamp | int64 | 时间戳(毫秒) |
| data.streams | string[] | 本次成功订阅的 stream 列表 |
推送数据
外层字段
| 字段 | 类型 | 说明 |
|---|---|---|
| event | string | 固定为 data |
| stream | string | 固定为 !miniTicker@arr@3000ms |
| channel | string | 固定为 miniTickerArr |
| timestamp | int64 | 推送时间戳(毫秒) |
| data | array | MiniTickerItem 数组,包含所有交易对 |
data[] 单条字段
| 字段 | 类型 | 说明 |
|---|---|---|
| s | string | 交易对,如 BTCUSDT |
| c | string | 最新价(收盘价) |
| o | string | 开盘价 |
| h | string | 24h 最高价 |
| l | string | 24h 最低价 |
| v | string | 24h 成交量 |
| P | string | 涨跌幅 %,保留 4 位小数 |
| E | int64 | 本条数据时间戳(毫秒) |
推送示例
{
"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
}
]
}