GET/v1/exchange/snapshots

Exchange Historical Snapshots

Historical Hyperliquid orderbook time-series. Sampled at ~1/sec and deduplicated (unchanged books are skipped; a row is guaranteed at least every ~5s). Returns lightweight top-of-book metrics only — no full bid/ask arrays. Scale and Enterprise tiers only.

Query Parameters

formatstringdefault:json

Response encoding. csv and tsv return the row array 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)).

exchangestringrequired

Exchange identifier

symbolstringrequired

Perp symbol — all 7 collected coins

fromstring

Start timestamp (defaults to last 24h)

tostring

End timestamp

limitnumberdefault:500

Max rows (default 500, max 5000)

Response

200401403404500

Successful Response

Code Snippet

curl -X GET "https://api.resolvedmarkets.com/v1/exchange/snapshots" \
  -H "X-API-Key: YOUR_API_KEY"

200

{
  "exchange": "hyperliquid_perp",
  "symbol": "BTC",
  "count": 100,
  "data": [
    {
      "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
    }
  ]
}