GET/v1/markets/:id/summary

Get Market Summary

Aggregate statistics for a market: price ranges, spreads, per-side breakdowns. Aggregates over the market's entire lifetime, so it works for markets of any age — including closed/historical markets, not just recently active ones. NOTE: markets that have been live for months at high capture frequency (season-long sports, long-dated event markets) can exceed the server-side query timeout and return 500 — use /snapshots?interval= OHLC candles for those instead.

Path Parameters

idstringrequired

Market ID (conditionId)

Query Parameters

formatstringdefault: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)).

Response

200401403404500

Successful Response

Code Snippet

curl -X GET "https://api.resolvedmarkets.com/v1/markets/:id/summary" \
  -H "X-API-Key: YOUR_API_KEY"

200

{
  "market_id": "0x...",
  "crypto": "BTC",
  "timeframe": "5m",
  "snapshot_count": 5400,
  "avg_spread": 0.012,
  "avg_crypto_price": 67420.50,
  "sides": [...]
}