Order Book (深度)

獲取深度數據

覆蓋範圍: 現貨 / USDT永續 / 反向合約

• 期貨: 最多返回500檔的數據.
• 現貨: 最多返回200檔的數據.

提示

響應是當前時間的切片數據

HTTP請求

GET /cloud/trade/v3/market/orderbook

請求參數

參數	是否必需	類型	說明
category	true	string	產品類型. spot,linear, inverse
symbol	true	string	合約名稱
limit	false	integer	深度限制. spot: [1, 200], 默認: 1. linear&inverse: [1, 500],默認: 25.

響應參數

參數	類型	說明
s	string	合約名稱
b	array	Bid, 買方. 按照價格從大到小
> b[0]	string	買方報價
> b[1]	string	買方數量
a	array	Ask, 賣方. 按照價格從小到大
> a[0]	string	賣方報價
> a[1]	string	賣方數量
ts	integer	行情服務生成數據時間戳（毫秒）
u	integer	表示數據連續性的id. 對於期貨, 它和wss推送裡的500檔的u對齊 對於現貨, 它和wss推送裡的200檔的u對齊

---

請求示例

GET /cloud/trade/v3/market/orderbook?category=linear&symbol=BTCUSDT HTTP/1.1
Host: openapi-testnet.zoomex.com

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "s": "BTCUSDT",
        "a": [
            [
                "16638.64",
                "0.008479"
            ]
        ],
        "b": [
            [
                "16638.27",
                "0.305749"
            ]
        ],
        "ts": 1672765737733,
        "u": 5277055
    },
    "retExtInfo": {},
    "time": 1672765737734
}