Contents

Order book liquidity and walls

Order book liquidity of one coin: resting USD per price bucket for every covered venue (Hyperliquid l2Book in a fine layer ≈ ±2 % and a coarse layer ≈ ±10–25 %, Binance / Bybit local books within ±5 %), depth within 1 / 2 / 5 % and the bid/ask imbalance, plus walls (large resting liquidity relative to the buckets around it) that are active or ended in the last hour.

GET/api/v1/orderbook/{coin}Every key

Description

Status pulled = removed before the price touched it, filled = the price traded into it. Walls cannot be attributed to wallets and a pulled wall is not proof of spoofing. With hours also the book heatmap over time (paid plans). Free keys: BTC, ETH and HYPE, current book only. Distances are fractions (walls[].distance, depth[].band; the older …Pct names hold the same fractions). Coins without a Hyperliquid market answer 404. Licence review: Binance / Bybit books and walls are withheld (meta.restricted); venue=binance|bybit answers 403 source_restricted.

Who can call it

Available with every key and keyless (X-Blockmetric-Access: public). Keys of Free accounts get free-tier data (real-time feeds, 30 days of history, heatmap over time for every coin over the last 24 hours, liquidation levels now for every coin, the same as the free web plan); Pro and Desk keys the data of their plan; API Dev / API Pro raise the limits.

No key: 24 h
Free: 30 days
Pro: 365 days
Desk: 1095 days
API Dev: 365 days
API Pro: 1095 days

History window per plan. Limits: Authentication & limits.

Parameters

Parameters of /orderbook/{coin}
Parameter	Description
`coin`string · pathrequired	Coin name, e.g. BTC (case-insensitive).
`venue`string	hyperliquid \| binance \| bybit (optional; default every covered venue the API serves).one of hyperliquid, binance, bybit
`hours`integer	Add the book heatmap over the last N hours (Pro / API Dev up to 168, Desk / API Pro up to 720); 0 or absent = current book only. Free keys: 403.0–720 · default 0

Response fields

Every success is { data, meta }; these are the fields of data. meta is the same on every endpoint.

Response fields of /orderbook/{coin}
Field	Description
`coin`string	Coin name as on Hyperliquid (BTC, kPEPE, HIP-3 names like xyz:TSLA).
`mid`number · nullable	Mid price between the best bid and ask.
`updatedAt`string (ISO 8601) · nullable	Newest snapshot.
`venues[]`array of objects	Venues covered by this view.
`venues[].venue`"hyperliquid" \| "binance" \| "bybit"	Venue of the order-flow data.
`venues[].layer`"fine" \| "coarse" \| "book"	fine / coarse = Hyperliquid l2Book with 3 / 2 significant figures (the coarse layer leaves out the fine range); book = local CEX order book.
`venues[].step`number	Bucket size (price).
`venues[].mid`number	Mid price (latest trade of the venue, else the book).
`venues[].ts`string (ISO 8601)	Snapshot time.
`venues[].lo`number	Lowest price covered.
`venues[].hi`number	Highest price covered.
`venues[].bids[]`array of objects	Bid buckets, from the price downwards.
`venues[].bids[].px`number	Lower edge of the price bucket.
`venues[].bids[].usd`number	Resting liquidity in the bucket (USD).
`venues[].asks[]`array of objects	Ask buckets, from the price upwards.
`venues[].asks[].px`number	Lower edge of the price bucket.
`venues[].asks[].usd`number	Resting liquidity in the bucket (USD).
`venues[].bidUsd`number	All bids of the snapshot (USD).
`venues[].askUsd`number	All asks of the snapshot (USD).
`venues[].bid1pct`number	Bids within 1 % of the mid (USD).
`venues[].ask1pct`number	Asks within 1 % of the mid (USD).
`depth[]`array of objects	Resting liquidity within bands around the mid (1 / 2 / 5 %).
`depth[].pct`number	Band around the mid (fraction, 0.01 = 1 %). Deprecated: use band (same value).
`depth[].band`number	Band around the mid, fraction (0.01 = 1 %).
`depth[].bidUsd`number	Bids in the band (USD).
`depth[].askUsd`number	Asks in the band (USD).
`depth[].imbalance`number · nullable	(bids - asks) / (bids + asks).
`walls[]`array of objects	Active walls and walls that ended in the last hour, active first, largest first.
`walls[].id`integer	Stable id of the item; on paginated feeds the order key together with ts.
`walls[].venue`"hyperliquid" \| "binance" \| "bybit"	Venue of the order-flow data.
`walls[].layer`"fine" \| "coarse" \| "book"	Storage layer the data was read from (enum of this field).
`walls[].side`"bid" \| "ask"	Position side (long / short); for trades and orders the side named in the description.
`walls[].px`number	Lower edge of the bucket.
`walls[].top`number	Upper edge of the bucket.
`walls[].usd`number	Size at the last sighting (USD).
`walls[].maxUsd`number	Largest size seen (USD).
`walls[].firstUsd`number	Size when first seen (USD).
`walls[].firstSeen`string (ISO 8601)	First time this item was observed (ISO 8601 UTC).
`walls[].lastSeen`string (ISO 8601)	Last time this item was observed (ISO 8601 UTC).
`walls[].endedAt`string (ISO 8601) · nullable	When it ended (ISO 8601 UTC); null while active.
`walls[].status`"active" \| "pulled" \| "filled" \| "gone"	pulled = removed before the price traded into it (not proof of spoofing); filled = the price traded into it while it shrank (consumed or cancelled at the touch); gone = left the observed range.
`walls[].distancePct`number	Distance from the price when first seen (fraction, 0.01 = 1 %). Deprecated: use distance (same value).
`walls[].minDistancePct`number	Closest distance to the price (fraction). Deprecated: use minDistance (same value).
`walls[].distance`number	Distance from the price when first seen, fraction (0.01 = 1 %).
`walls[].minDistance`number	Closest distance to the price, fraction.
`walls[].touchedAt`string (ISO 8601) · nullable	First time the price traded into the bucket.
`walls[].lifetimeSec`integer	Seconds from first sighting to the end (or the last sighting).
`walls[].history[]`array of array	[secondsSinceFirstSeen, usd] at size changes of 20 % or more.
`heatmap`object · nullable	Order book heatmap over time (with ?hours=), else null.
`heatmap.coin`string	Coin name as on Hyperliquid (BTC, kPEPE, HIP-3 names like xyz:TSLA).
`heatmap.venues[]`array of "hyperliquid" \| "binance" \| "bybit"	Venues covered by this view.
`heatmap.times[]`array of string (ISO 8601)	Column start times, oldest to newest.
`heatmap.colMs`integer	Column width in milliseconds.
`heatmap.prices[]`array of number	Lower edge of each price row, ascending.
`heatmap.rowStep`number	Price step between rows.
`heatmap.bid[]`array of array	bid[timeIndex][priceIndex]: resting bids in USD (rounded to $1,000).
`heatmap.ask[]`array of array	Same shape, resting asks.
`heatmap.mid[]`array of number	Mid price per column (null without a snapshot).
`heatmap.candles`object	OHLC of taker trades per column.
`heatmap.candles.o[]`array of number	Open price per column (null = no trade).
`heatmap.candles.h[]`array of number	High price per column.
`heatmap.candles.l[]`array of number	Low price per column.
`heatmap.candles.c[]`array of number	Close price per column.
`heatmap.candles.venue`"hyperliquid" \| "binance" \| "bybit" · nullable	Venue of the order-flow data.
`heatmap.maxUsd`number	Largest cell (USD).
`heatmap.coarse[]`array of objects	Coarse layers whose buckets can be wider than a row (each drawn whole in the row of its centre).
`heatmap.coarse[].venue`"hyperliquid" \| "binance" \| "bybit"	Venue of the order-flow data.
`heatmap.coarse[].step`number	Price step of the buckets.
`heatmap.updatedAt`string (ISO 8601) · nullable	Newest data time of this item (ISO 8601 UTC).

Errors

400invalid_param Invalid parameter
401unauthorized Missing or invalid API key
403plan_required Plan does not include this
403scope_required Key not scoped for this API
403ip_not_allowed Address not on the IP allowlist of the key
403origin_not_allowed Key used from a browser origin it does not allow
403source_restricted Exchange data not redistributed
403https_required https required
404not_found Not found
429rate_limited Per-minute limit reachedretry
429daily_limit_exceeded Daily limit reachedretry
429stream_limit Too many open streamsretry
500internal_error Internal errorretry

Methodology

Order book walls (how it is computed and its limits)

Request

curl -s -H "X-Blockmetric-Access: public" \
  "https://api.blockmetric.io/v1/orderbook/BTC"

Example response

HTTP 200Real data from 2026-10-27 13:11 UTC

{
  "data": {
    "coin": "BTC",
    "mid": 80214,
    "updatedAt": "2026-10-27T13:11:30.000Z",
    "venues": [
      {
        "venue": "hyperliquid",
        "layer": "fine",
        "step": 100,
        "mid": 80214,
        "ts": "2026-10-27T13:11:30.000Z",
        "lo": 78300,
        "hi": 82200,
        "bids": [
          {
            "px": 80200,
            "usd": 2980000
          },
          {
            "px": 80100,
            "usd": 32300000
          }
        ],
        "asks": [
          {
            "px": 80200,
            "usd": 26500000
          },
          {
            "px": 80300,
            "usd": 23400000
          }
        ],
        "bidUsd": 209248635,
        "askUsd": 173346849,
        "bid1pct": 119209022,
        "ask1pct": 127069252
      },
      {
        "venue": "hyperliquid",
        "layer": "coarse",
        "step": 1000,
        "mid": 80214,
        "ts": "2026-10-27T13:11:30.000Z",
        "lo": 61000,
        "hi": 100000,
        "bids": [
          {
            "px": 77000,
            "usd": 35100000
          },
          {
            "px": 76000,
            "usd": 35400000
          }
        ],
        "asks": [
          {
            "px": 83000,
            "usd": 18300000
          },
          {
            "px": 84000,
            "usd": 23500000
          }
        ],
        "bidUsd": 254383813,
        "askUsd": 101123260,
        "bid1pct": 0,
        "ask1pct": 0
      }
    ],
    "depth": [
      {
        "pct": 0.01,
        "bidUsd": 116200000,
        "askUsd": 127150000,
        "imbalance": -0.045,
        "band": 0.01
      },
      {
        "pct": 0.02,
        "bidUsd": 190380000,
        "askUsd": 163460000,
        "imbalance": 0.076,
        "band": 0.02
      }
    ],
    "walls": [
      {
        "id": 19798,
        "venue": "hyperliquid",
        "layer": "fine",
        "side": "ask",
        "px": 80300,
        "top": 80400,
        "usd": 32898183,
        "maxUsd": 54462630,
        "firstUsd": 53829356,
        "firstSeen": "2026-10-27T12:44:06.530Z",
        "lastSeen": "2026-10-27T12:48:42.274Z",
        "endedAt": "2026-10-27T12:48:47.290Z",
        "status": "filled",
        "distancePct": 0.00006,
        "minDistancePct": 0,
        "touchedAt": "2026-10-27T12:44:26.574Z",
        "lifetimeSec": 281,
        "history": [
          [
            0,
            53829356
          ],
          [
            30,
            37145198
          ]
        ],
        "distance": 0.00006,
        "minDistance": 0
      },
      {
        "id": 19870,
        "venue": "hyperliquid",
        "layer": "fine",
        "side": "ask",
        "px": 80300,
        "top": 80400,
        "usd": 21768932,
        "maxUsd": 47131362,
        "firstUsd": 43208804,
        "firstSeen": "2026-10-27T13:03:09.590Z",
        "lastSeen": "2026-10-27T13:06:50.184Z",
        "endedAt": "2026-10-27T13:06:55.191Z",
        "status": "pulled",
        "distancePct": 0.00016,
        "minDistancePct": 0.00016,
        "touchedAt": null,
        "lifetimeSec": 226,
        "history": [
          [
            0,
            43208804
          ],
          [
            40,
            33706274
          ]
        ],
        "distance": 0.00016,
        "minDistance": 0.00016
      }
    ],
    "heatmap": null
  },
  "meta": {
    "updatedAt": "2026-10-27T13:11:30.000Z",
    "source": "hyperliquid",
    "sources": [
      "hyperliquid"
    ],
    "plan": "api_dev",
    "delayMinutes": 0,
    "commercial": false,
    "license": {
      "id": "internal",
      "display": false,
      "attributionRequired": false,
      "attribution": null,
      "redistribution": false,
      "mauCap": null,
      "terms": "https://blockmetric.io/terms#api-license"
    },
    "attribution": {
      "text": "Data by Blockmetric · Source: Blockmetric Research",
      "url": "https://blockmetric.io/"
    },
    "access": {
      "historyDays": 365,
      "historyFrom": "2025-10-27T13:14:00.000Z"
    },
    "restricted": [
      "binance",
      "bybit"
    ]
  }
}

More options: open in the explorer · SDK method orderbook() / orderbook()

Code snippets in these docs are licensed under MIT-0: copy them into your own code without attribution. The SDKs, CLI and MCP server will be, once published, Apache-2.0; the name Blockmetric is not licensed (forks must be renamed). Data from the API is governed by the API terms; third-party exchange data by the exchange’s terms.