> For the complete documentation index, see [llms.txt](https://hyperliquid-ohlc.gitbook.io/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hyperliquid-ohlc.gitbook.io/api-docs/rest-api/orderbook/orderbook-depth.md).

# Orderbook Depth

## Hyperliquid orderbook depth time-series

> 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).

```json
{"openapi":"3.1.0","info":{"title":"BlockLiquidity API Service","version":"1.0.0"},"servers":[{"url":"https://data.blockliquidity.xyz"}],"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}},"schemas":{"DepthLevel":{"type":"string","enum":["0_5pct","1pct","2_5pct","5pct","10pct"],"title":"DepthLevel"},"OrderbookDepthResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/OrderbookDepthDataPoint"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"OrderbookDepthResponse"},"OrderbookDepthDataPoint":{"properties":{"timestamp":{"type":"integer","title":"Timestamp"},"token":{"type":"string","title":"Token"},"net_depth":{"type":"number","title":"Net Depth"},"bid_depth":{"type":"number","title":"Bid Depth"},"ask_depth":{"type":"number","title":"Ask Depth"}},"type":"object","required":["timestamp","token","net_depth","bid_depth","ask_depth"],"title":"OrderbookDepthDataPoint"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v1/orderbook/depth":{"get":{"tags":["Orderbook Data"],"summary":"Hyperliquid orderbook depth time-series","description":"Returns historical orderbook depth snapshots for a Hyperliquid token.\n\n**Fields returned per data point:**\n- bid_depth: Total bid-side liquidity in USDC within the selected price band\n- ask_depth: Total ask-side liquidity in USDC within the selected price band\n- net_depth: bid_depth - ask_depth (positive = buying pressure, negative = selling pressure)\n\n**Timeframes:**\n- 30min — raw 30-minute snapshots\n- 1d — last snapshot of each calendar day (UTC)\n\n**Time range:** supply start_timestamp / end_timestamp (Unix ms).","operationId":"get_orderbook_depth_v1_orderbook_depth_get","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","description":"Token symbol, e.g. BTC, ETH, SOL","title":"Token"},"description":"Token symbol, e.g. BTC, ETH, SOL"},{"name":"depth_level","in":"query","required":false,"schema":{"$ref":"#/components/schemas/DepthLevel","description":"Orderbook depth band: 0_5pct | 1pct | 2_5pct | 5pct | 10pct","default":"1pct"},"description":"Orderbook depth band: 0_5pct | 1pct | 2_5pct | 5pct | 10pct"},{"name":"timeframe","in":"query","required":false,"schema":{"enum":["30min","1d"],"type":"string","description":"Data granularity: 30min (raw snapshots) or 1d (last snapshot per day)","default":"1d","title":"Timeframe"},"description":"Data granularity: 30min (raw snapshots) or 1d (last snapshot per day)"},{"name":"start_timestamp","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"Range start in Unix epoch milliseconds","title":"Start Timestamp"},"description":"Range start in Unix epoch milliseconds"},{"name":"end_timestamp","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"Range end in Unix epoch milliseconds","title":"End Timestamp"},"description":"Range end in Unix epoch milliseconds"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Maximum number of data points to return","default":30,"title":"Limit"},"description":"Maximum number of data points to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderbookDepthResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```