跳轉到主要內容
GET
/
v1
/
market
/
depth
Order Book Depth
curl --request GET \
  --url https://api.tickdb.ai/v1/market/depth \
  --header 'X-API-Key: <api-key>'
{
  "code": 0,
  "message": "success",
  "data": {
    "symbol": "BTCUSDT",
    "timestamp": 1703123456789,
    "bids": [
      [
        "43100.00",
        "1.25"
      ]
    ],
    "asks": [
      [
        "43101.00",
        "0.85"
      ]
    ]
  }
}
GET /v1/market/depth

​
概述

獲取交易品種的實時訂單簿深度（買賣盤）數據。

​
多市場示例

加密貨幣：BTCUSDT、ETHUSDT、ADAUSDT 美股：AAPL.US、TSLA.US、MSFT.US 港股：700.HK、9988.HK、3690.HK 
curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.tickdb.ai/v1/market/depth?symbol=700.HK&limit=10"

​
響應示例

{
    "code": 0,
    "message": "success",
    "data": {
        "symbol": "700.HK",
        "timestamp": 1768274016162,
        "bids": [
            [
                "626",
                "19700"
            ],
            [
                "625.5",
                "40800"
            ],
            [
                "625",
                "58200"
            ],
            [
                "624.5",
                "23600"
            ],
            [
                "624",
                "31300"
            ],
            [
                "623.5",
                "37500"
            ],
            [
                "623",
                "47200"
            ],
            [
                "622.5",
                "17000"
            ],
            [
                "622",
                "12700"
            ],
            [
                "621.5",
                "5600"
            ]
        ],
        "asks": [
            [
                "626.5",
                "36100"
            ],
            [
                "627",
                "50700"
            ],
            [
                "627.5",
                "49100"
            ],
            [
                "628",
                "54000"
            ],
            [
                "628.5",
                "37500"
            ],
            [
                "629",
                "37100"
            ],
            [
                "629.5",
                "43600"
            ],
            [
                "630",
                "78900"
            ],
            [
                "630.5",
                "53500"
            ],
            [
                "631",
                "37700"
            ]
        ]
    }
}

​
注意事項

  • 買盤（bids）按價格降序排列
  • 賣盤（asks）按價格升序排列
  • 時間戳單位為毫秒（UTC）

授權

​
X-API-Key
string
header
必填

查詢參數

​
symbol
string
必填

Trading symbol

範例:

"BTCUSDT"

​
limit
integer
預設值:10

Depth levels (default 10, max 50)

必填範圍: 1 <= x <= 50
範例:

20

回應

200 - application/json

Successful response

​
code
integer
範例:

0

​
message
string
範例:

"success"

​
data
object