訂單簿數據推送
連接信息
連接端點: wss://{host}/ws/orderbooks/v1?symbols=doge@dcex/eth@dcex
描述: 為 Maker 提供實現訂單簿數據推送
鑑權: 通過子協議(subprotocols)傳遞JWT令牌
查詢參數
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
| symbols | string | 是 | URL參數,單個格式為{symbol}@{market},多個使用/拼接。市場可能的值為usex/hkex/dcex。 美股單個格式可以不指定市場,即不需要@{market}部分 |
訂單狀態變更通知
當訂單狀態發生變更時,會收到以下格式的消息:
json
{
"type": "orderbook_update",
"timestamp": "2026-01-19T06:55:49.301529733Z",
"data": {
"symbol": "DOGE",
"market": "dcex",
"bid": [],
"ask": [
{
"price": 0.12988,
"volume": 6.0
},
{
"price": 0.13083,
"volume": 5.0
}
],
"time": "2025-12-24T01:33:24Z"
}
}消息字段說明
| 字段 | 類型 | 說明 |
|---|---|---|
| type | string | 消息類型 |
| timestamp | string | timestamp,消息時間 |
| data | object | 訂單狀態變更數據 |
| data.symbol | string | 股票代碼 |
| data.market | string | 市場代碼枚舉項。詳見Market枚舉類型說明 |
| data.ask | object array | 賣盤 |
| data.ask[].price | decimal | 對應市場的價格 |
| data.ask[].volume | decimal | 數量 |
| data.bid | object array | 買盤 |
| data.bid[].price | decimal | 對應市場的價格 |
| data.bid[].volume | decimal | 數量 |
| data.time | string | 數據時間 |
服務端心跳
服務端會在一定間隔時間對鏈接發送心跳消息:
json
{
"type": "heartbeat",
"timestamp": 1763722070521
}枚舉類型
WebSocketDataType - WebSocket消息類型
| 枚舉項 | 說明 |
|---|---|
| heartbeat | 服務端側心跳通知 |
| order_status_change | 訂單狀態變更 |