跳轉到內容

訂單簿數據推送

連接信息

連接端點: wss://{host}/ws/orderbooks/v1?symbols=doge@dcex/eth@dcex

描述: 為 Maker 提供實現訂單簿數據推送

鑑權: 通過子協議(subprotocols)傳遞JWT令牌

查詢參數

參數類型必填說明
symbolsstringURL參數,單個格式為{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"
  }
}

消息字段說明

字段類型說明
typestring消息類型
timestampstringtimestamp,消息時間
dataobject訂單狀態變更數據
data.symbolstring股票代碼
data.marketstring市場代碼枚舉項。詳見Market枚舉類型說明
data.askobject array賣盤
data.ask[].pricedecimal對應市場的價格
data.ask[].volumedecimal數量
data.bidobject array買盤
data.bid[].pricedecimal對應市場的價格
data.bid[].volumedecimal數量
data.timestring數據時間

服務端心跳

服務端會在一定間隔時間對鏈接發送心跳消息:

json
{
  "type": "heartbeat",
  "timestamp": 1763722070521
}

枚舉類型

WebSocketDataType - WebSocket消息類型

枚舉項說明
heartbeat服務端側心跳通知
order_status_change訂單狀態變更