Resolved Markets logoResolved Markets logo
Developer Guide

How to access Polymarket historical orderbook data

Polymarket exposes live market state, but researchers often need the orderbook as it looked yesterday, last week, or during a specific event. Resolved Markets stores point-in-time Polymarket orderbook snapshots with full bid/ask depth and exposes them through REST, OpenAPI, CLI export, and MCP.

Last updated:

  • Full depthSnapshot contents
  • MillisecondsTimestamp precision
  • Up to 500REST page size
  • CLI parquet exportBulk workflow

Three-step REST workflow

  1. Find a market. Use /v1/markets/live for active markets or /v1/markets/history for previously tracked markets.
  2. Query snapshots. Use /v1/markets/:id/snapshots with from, to, side, and limit.
  3. Analyze the book. Use best_bid, best_ask, mid, spread, bids, asks, and sequence_number for replay or backtesting.
# 1. Find active BTC markets
curl -s "https://api.resolvedmarkets.com/v1/markets/live?category=crypto&subcategory=BTC" \
  -H "X-API-Key: rm_your_key" | jq '.markets[] | {condition_id, slug, question}'

# 2. Pull historical snapshots
curl -s "https://api.resolvedmarkets.com/v1/markets/<condition_id>/snapshots?from=2026-05-01T00:00:00Z&to=2026-05-01T01:00:00Z&limit=500" \
  -H "X-API-Key: rm_your_key" | jq '.snapshots[0]'

# 3. Export with the CLI for larger research jobs
rm-api download --category crypto --subcategory BTC --from 2026-05-01 --to 2026-05-02 --format parquet --out ./btc/

Snapshot fields that matter

  • Full depth: bids and asks arrays, not just top-of-book.
  • Derived prices: best_bid, best_ask, mid, and spread.
  • Replay safety: sequence_number for gap detection.
  • Timing: event and capture timestamps for latency-sensitive research.
  • Context: paired spot crypto fields where applicable.

Frequently asked questions

How do I access Polymarket historical orderbook data?

List markets with GET /v1/markets/live or /v1/markets/history, then call GET /v1/markets/:id/snapshots with from, to, side, and limit query parameters. Each response returns point-in-time bid and ask arrays plus derived fields.

What fields are included in a historical snapshot?

Snapshots include condition_id, token_id, side, event_timestamp, capture_timestamp, sequence_number, best_bid, best_ask, mid, spread, full bids and asks arrays, top-5 depth, and paired crypto spot fields where applicable.

How far back does history go?

Resolved Markets keeps the full archive for captured markets. Exact earliest availability depends on when a market category entered the pipeline; Pro and Enterprise plans do not have a fixed 31-day retention cliff.

Can I export data to parquet?

Yes. The rm-api CLI supports bulk downloads to local files for research workflows. Enterprise users can also request direct ClickHouse access for large analytical queries.

Get an API keyOpenAPI spec

Related resources