Skip to main content

Get Order Book

Get current order book (market depth) for a trading pair.

HTTP Request

GET /api/v1/spot/market/orderbook

Request Parameters

ParameterTypeRequiredDescription
symbolstringYesTrading pair symbol (e.g., BTCUSDT)

Request Example

curl -X GET "https://open-api.bydoxe.com/api/v1/spot/market/orderbook?symbol=BTCUSDT"

Response Parameters

ParameterTypeDescription
codestringResponse code
msgstringResponse message
requestTimenumberRequest timestamp in milliseconds
dataobjectResponse data
> asksarraySell orders [price, quantity] sorted by price ascending
> bidsarrayBuy orders [price, quantity] sorted by price descending
> tsstringOrder book timestamp in milliseconds

Response Example

Success Response

{
"code": "00000",
"msg": "success",
"requestTime": 1732000000000,
"data": {
"asks": [
["91240.00", "0.6"],
["91250.00", "1.2"],
["91260.00", "0.8"]
],
"bids": [
["91230.00", "0.5"],
["91220.00", "1.5"],
["91210.00", "2.0"]
],
"ts": "1763459280833"
}
}

Error Codes

CodeMessage
40034symbol does not exist
50010Orderbook data not available