Skip to main content
GET
/
v1
/
market
/
depth
Order Book
curl --request GET \
  --url https://api.tickdb.ai/v1/market/depth \
  --header 'X-API-Key: <api-key>'
{
  "code": 0,
  "message": "success",
  "data": {
    "symbol": "700.HK",
    "timestamp": 1768274016162,
    "bids": [
      [
        "626",
        "19700"
      ],
      [
        "625.5",
        "40800"
      ]
    ],
    "asks": [
      [
        "626.5",
        "36100"
      ],
      [
        "627",
        "50700"
      ]
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.tickdb.ai/llms.txt

Use this file to discover all available pages before exploring further.

Notes

  • bids sorted by price descending
  • asks sorted by price ascending
  • timestamp in milliseconds (UTC)

Supported Markets

US Stocks, HK Stocks, Crypto Examples:
  • US Stocks: AAPL.US, TSLA.US, MSFT.US
  • HK Stocks: 700.HK, 9988.HK, 3690.HK
  • Crypto: BTCUSDT, ETHUSDT, ADAUSDT

Request Parameters

ParameterRequiredDescription
symbolYesTrading symbol code
limitNoDepth levels, default 10, max 50

Response Fields

FieldDescription
symbolTrading Symbol
timestampData timestamp (milliseconds, UTC)
bidsBid array, each element is [price, quantity]
asksAsk array, each element is [price, quantity]

Authorizations

X-API-Key
string
header
required

Query Parameters

symbol
string
default:700.HK
required

Trading symbol

Example:

"700.HK"

limit
integer

Depth levels (default 10, max 50)

Required range: 1 <= x <= 50
Example:

20

Response

200 - application/json

Successful response

code
integer
Example:

0

message
string
Example:

"success"

data
object