Depth

The endpoint retrieves depth price levels within ±2% of the market last price. Use when lightweight order book data is needed for a narrow price band around the current market price. The ±2% constraint limits the response to price levels near the last traded price, reducing payload size compared to the full order book.

The API caches the response for 1 sec

Rate limit: 2000 requests/10 sec. See Public API V4 overview for rate limit details.

GET /api/v4/public/orderbook/depth/{market}

Depth

cURL

curl --request GET \
  --url https://whitebit.com/api/v4/public/orderbook/depth/{market}

200

{
  "ticker_id": "BTC_PERP",
  "timestamp": 1594391413,
  "asks": [
    [
      "9184.41",
      "0.773162"
    ]
  ],
  "bids": [
    [
      "9181.19",
      "0.010873"
    ]
  ]
}

Public depth endpoints exclude Retail Price Improvement (RPI) orders. RPI orders appear only in private active orders (private API/WebSocket) and in the exchange UI order book (web and mobile).

Path Parameters

market · string · required

Market pair name

Example:

"BTC_USDT"

Response

200

application/json

Successful response

ticker_id · string

Market Name

Example:

"BTC_PERP"

timestamp · integer

Current timestamp

Example:

1594391413

asks · string[][]

Array of ask orders

[price, quantity] — price in quote currency, quantity in base currency

Required array length: 2 elements

Example:

["9184.41", "0.773162"]

bids · string[][]

Array of bid orders

[price, quantity] — price in quote currency, quantity in base currency

Required array length: 2 elements

Example:

["9181.19", "0.010873"]