Get Orderbook Depth

Get the full orderbook depth (bids and asks) for a futures symbol.

HTTP Request

GET /api/v1/future/market/depth

Request Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Trading pair symbol (e.g., BTCUSDT)
limit	number	No	Number of levels to return (default: 500, max: 1000)

Request Example

curl -X GET "https://open-api.bydoxe.com/api/v1/future/market/depth?symbol=BTCUSDT&limit=500"

Response Parameters

Parameter	Type	Description
code	string	Response code
msg	string	Response message
requestTime	number	Request timestamp in milliseconds
data	object	Orderbook depth data
> asks	array	Array of ask orders [price, quantity]
> bids	array	Array of bid orders [price, quantity]
> ts	number	Data timestamp in milliseconds (Unix timestamp)

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1732000000000,
  "data": {
    "asks": [["91210.20", "0.1"]],
    "bids": [["91200.10", "0.2"]],
    "ts": 1763459280833
  }
}

Error Codes

Code	Message
40034	symbol does not exist
40034	Limit parameter limit does not exist
50010	Upstream response invalid