GET/v1/markets/:id/snapshots

Get Market Snapshots

Paginated time-series orderbook snapshots for a specific market. Rows carry category/subcategory/label for identity; crypto and crypto_price appear only on crypto-category markets (omitted on sports/weather/equities — the underlying spot price only exists for crypto). Raw rows (default and includebook modes) also carry four data-fidelity fields — event_timestamp (Polymarket emit time), capture_timestamp (our store time; the difference is ingestion latency), sequence_number (monotonic per-stream counter for gap detection) and crypto_price_age_ms (spot-price staleness, -1 when untracked) — matching /api/snapshot?includebook=true. These are NOT present on interval (OHLC candle) rows.

Path Parameters

idstringrequired

Market ID (conditionId)

Query Parameters

sidestring

Token side filter

fromstring

Start timestamp

tostring

End timestamp

intervalstring

Downsample to OHLC candles instead of raw rows. Each bucket returns open/high/low/close/vwap_mid plus avg spread, depth and a snapshot_count — one candle per (bucket × token_side). Turns a 200k-row pull into a few thousand rows: a 4-day market at 500ms cadence goes from ~89k rows (18 pages) to ~1.5k candles in a single call.

limitnumberdefault:500

Max rows (default 500, max 5000)

offsetnumberdefault:0

Pagination offset

includebookbooleandefault:false

Include full bid/ask arrays in each row. Off by default for payload size; turn on when you need depth.

orderstringdefault:desc

Sort by timestamp: asc/oldest (chronological) or desc/newest (reverse). Defaults to desc.

contextstring

Set to "replay" to apply free-tier replay quota gating

Response

200401403404500

Successful Response

Code Snippet

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

200

{
  "market_id": "0x...",
  "total": 5400,
  "limit": 100,
  "offset": 0,
  "data": [
    {
      "timestamp": "2026-03-02 15:30:00.123",
      "token_side": "UP",
      "best_bid": 0.52,
      "best_ask": 0.53,
      "event_timestamp": "2026-03-02 15:30:00.081",
      "capture_timestamp": "2026-03-02 15:30:00.123",
      "sequence_number": 148213,
      "crypto_price_age_ms": 42
    }
  ]
}