Get Symbol Order Book Ticker

Get the best bid and ask prices from the orderbook for futures symbols.

HTTP Request

GET /api/v1/future/market/book-ticker

Request Parameters

Parameter	Type	Required	Description
symbol	string	No	Trading pair symbol (e.g., BTCUSDT). If omitted, returns all symbols

Request Example

Single Symbol Request

curl -X GET "https://open-api.bydoxe.com/api/v1/future/market/book-ticker?symbol=BTCUSDT"

All Symbols Request

curl -X GET "https://open-api.bydoxe.com/api/v1/future/market/book-ticker"

Response Parameters

Parameter	Type	Description
code	string	Response code
msg	string	Response message
requestTime	number	Request timestamp in milliseconds
data	object/array	Response data (object for single symbol, array for all)
> symbol	string	Trading pair symbol
> bidPrice	string	Best bid (buy) price
> bidQty	string	Quantity available at the best bid price
> askPrice	string	Best ask (sell) price
> askQty	string	Quantity available at the best ask price
> ts	number	Data timestamp in milliseconds (Unix timestamp)

Response Example

Success Response (Single Symbol)

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1732000000000,
  "data": {
    "symbol": "BTCUSDT",
    "bidPrice": "91200.10",
    "bidQty": "1.234",
    "askPrice": "91210.20",
    "askQty": "0.987",
    "ts": 1763459280833
  }
}

Success Response (All Symbols)

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1732000000000,
  "data": [
    {
      "symbol": "BTCUSDT",
      "bidPrice": "91200.10",
      "bidQty": "1.234",
      "askPrice": "91210.20",
      "askQty": "0.987",
      "ts": 1763459280833
    },
    {
      "symbol": "ETHUSDT",
      "bidPrice": "3450.50",
      "bidQty": "10.5",
      "askPrice": "3451.00",
      "askQty": "8.3",
      "ts": 1763459280833
    }
  ]
}

Error Codes

Code	Message
40034	symbol does not exist
50010	Upstream response invalid