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