---
title: "Get Depth For Coin"
method: GET
path: "/api/v1/liquidity/depth/{coin}"
tags: ["Liquidity / Market Depth"]
---

# Get Depth For Coin

`GET /api/v1/liquidity/depth/{coin}`

## Request

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

Per-coin depth history (rolling, up to 24h). Free: BTC only; Pro + Pro Plus: any tracked coin.

**Tracked universe is the top 25 Hyperliquid perps by 24h notional** (re-
selected each sweep), not every coin — an untracked coin 404s. The current
set is the ``coins`` list on ``/liquidity/depth``.

``minutes`` is a **time** window measured back from now, not a row count.
Sampling runs on a ~2-minute timer and can skip, so ``count`` is the number of
snapshots that actually landed in the window — expect roughly ``minutes / 2``,
fewer after a stall. Each record carries ``ts`` so staleness is visible.

Each record carries ``depth_usd.bid`` / ``depth_usd.ask`` per band
(10/25/50/100 bps) plus ``imbalance_10bps``. ``levels_truncated`` flags,
per band per side, when the deepest level in HL's ~20-level snapshot still
sat inside the band — that band's ``depth_usd`` is then a lower bound on
the true resting depth, not the depth.

## Path parameters

- `coin` string, required

## Query parameters

- `minutes` integer: Trailing wall-clock minutes of history (max 24h)

## Response `200`

Successful Response

- CoinDepthHistoryResponse
  - `coin` string, required
  - `minutes` integer, required
  - `count` integer, required
  - `history` 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

## Other responses

- `422`: Validation Error

---

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