---
title: "Get Depth"
method: GET
path: "/api/v1/liquidity/depth"
tags: ["Liquidity / Market Depth"]
---

# Get Depth

`GET /api/v1/liquidity/depth`

## Request

- Base URL: `https://cryptodataapi.com`
- URL: `https://cryptodataapi.com/api/v1/liquidity/depth`
- Auth: API key in header `X-API-Key`

Current per-coin depth/spread snapshot across the tracked universe.

Returns one record per coin (top-25 HL perps by 24h volume):
bid/ask depth in USD at {10, 25, 50, 100}bps from mid, spread in bps,
book imbalance within 10bps, and joined open interest.

The free tier is scoped to BTC; full-universe coverage is Pro and Pro Plus.

## Response `200`

Successful Response

- DepthResponse
  - `as_of` integer, required
  - `universe_size` integer, required
  - `coins` CoinDepthSnapshot[], required
    - `coin` string, required
    - `ts` integer, required
    - `mid_price` number, required
    - `spread_bps` number, nullable
    - `bid_levels` integer, required
    - `ask_levels` integer, required
    - `depth_usd` DepthBuckets: Cumulative bid/ask notional within bps buckets from mid.
      - `bid` object
      - `ask` object
    - `levels_truncated` object, nullable: {bid: {10bps: bool, ...}, ask: {...}} — band saturated the returned book levels; its depth_usd is a lower bound
    - `total_depth_25bps_usd` number, nullable
    - `imbalance_10bps` number, nullable
    - `open_interest_usd` number, nullable

---

[API](https://skmtc.dev/cryptodataapi/apis/crypto-data-api.md) · [All operations](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/revisions/8628b754ca81?raw)