> For the complete documentation index, see [llms.txt](https://resolvedmarkets.com/llms.txt). Every docs page is also served as Markdown: append `.md` to its URL or send `Accept: text/markdown`.

# Exchange Live Orderbook

### GET /v1/exchange/orderbook — Exchange Live Orderbook

Returns the most recent L2 orderbook snapshot (full 20-level bids/asks) for Hyperliquid perpetual futures — BTC, ETH, SOL, XRP. Only rows from the last 60 seconds count as live; returns 404 "No recent data" otherwise (retry shortly). Scale and Enterprise tiers only (Free/Pro get 403).

**Query parameters**

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `format` | string | no | json | Response encoding. csv and tsv return the rows as a flat file instead of a JSON envelope — the envelope moves to X-* response headers and nulls render as \N. REQUIRES SCALE OR ENTERPRISE (json is available on every tier). Works with includebook=true — the bids/asks ladders come through as compact JSON inside their cell, complete and parseable (pandas: df["bids"].apply(json.loads)). |
| `exchange` | string | yes | — | Exchange identifier |
| `symbol` | string | yes | — | Perp symbol — all 7 collected coins |

**Example response**

```json
{
  "exchange": "hyperliquid_perp",
  "symbol": "BTC",
  "timestamp": "2026-03-27 14:30:00.123",
  "best_bid": 87420.50,
  "best_ask": 87421.00,
  "mid_price": 87420.75,
  "spread": 0.50,
  "bid_depth_total": 4250000,
  "ask_depth_total": 3890000,
  "bids": [[87420.5, 1.2], [87420.0, 0.8], ...],
  "asks": [[87421.0, 0.5], [87421.5, 1.1], ...]
}
```
