Orderbook Depth

Hyperliquid orderbook depth time-series

get

Returns historical orderbook depth snapshots for a Hyperliquid token.

Fields returned per data point:

• bid_depth: Total bid-side liquidity in USDC within the selected price band

• ask_depth: Total ask-side liquidity in USDC within the selected price band

• net_depth: bid_depth - ask_depth (positive = buying pressure, negative = selling pressure)

Timeframes:

• 30min — raw 30-minute snapshots

• 1d — last snapshot of each calendar day (UTC)

Time range: supply start_timestamp / end_timestamp (Unix ms).

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

tokenstringRequired

Token symbol, e.g. BTC, ETH, SOL

depth_levelstring · enumOptional

Orderbook depth band: 0_5pct | 1pct | 2_5pct | 5pct | 10pct

Default: 1pctPossible values:

timeframestring · enumOptional

Data granularity: 30min (raw snapshots) or 1d (last snapshot per day)

Default: 1dPossible values:

start_timestampany ofOptional

Range start in Unix epoch milliseconds

integerOptional

or

nullOptional

end_timestampany ofOptional

Range end in Unix epoch milliseconds

integerOptional

or

nullOptional

limitinteger · min: 1 · max: 1000Optional

Maximum number of data points to return

Default: 30

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/v1/orderbook/depth

HTTPcURLJavaScriptPython

GET /v1/orderbook/depth?token=text HTTP/1.1
Host: data.blockliquidity.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "timestamp": 1,
      "token": "text",
      "net_depth": 1,
      "bid_depth": 1,
      "ask_depth": 1
    }
  ]
}