Overview

The PolyOrderbooks API gives you programmatic access to historical Polymarket crypto markets: discovery metadata, outcome prices, liquidity metrics, and L2 order book snapshots. Data is collected continuously into our historical store and served with consistent latency.

Production base URL

https://api.polyorderbooks.com

Paths in this documentation are relative to that host. Every /v1 data route requires a valid API key.

Quick start

Authenticate and query the catalog and history:

# 1. Discover markets (API key required)
curl -s -H "X-API-Key: $POLYORDERBOOKS_API_KEY" \
  "https://api.polyorderbooks.com/v1/markets?search=bitcoin&limit=5"

# 2. Order book history (Starter finest resolution: 60s)
curl -s -H "X-API-Key: $POLYORDERBOOKS_API_KEY" \
  "https://api.polyorderbooks.com/v1/markets/MARKET_SLUG/books" \
  --get \
  --data-urlencode "start_ts=2026-07-26T00:00:00Z" \
  --data-urlencode "end_ts=2026-07-26T06:00:00Z" \
  --data-urlencode "resolution=60s"

Use the Try playground on endpoint pages after adding your X-API-Key header.

First time here?

Create an account, verify your email, generate an API key, and run your first historical query.

What you can build

Market discovery

Search series, events, and markets with tags, status, volume, and date filters.

Price history

Outcome-level prices from 1-second native capture through daily aggregates.

Liquidity analytics

Volume, liquidity, and spread for execution-quality and microstructure research.

Order book depth

Historical L2 bid and ask ladders for slippage and depth analysis.

Coverage

Today we ingest and serve Polymarket crypto markets only. Other categories may be added later. See Discovery overview for catalog scope.

Data model

Series  →  Events  →  Markets  →  Tokens (Yes / No / …)

Discover

Search with GET /v1/markets or browse series and events.

Resolve

Read GET /v1/markets/{id_or_slug} for outcome token identifiers and resolution state.

Query history

Request prices, metrics, or books over your time window.

Design principles

Principle	Detail
Read-local	Discovery and history query our data store only — not live Polymarket APIs.
Sparse → uniform	Captures are stored on change; the API materializes uniform buckets via last-value carry.
Stable identifiers	Markets accept source id, URL slug, or scoped public id (`polymarket:market:<id>`).
Cursor pagination	Large result sets paginate with opaque cursors — see Pagination.
Plan enforcement	Resolution floor, history window, and rate limits are enforced per API key — see Pricing.

Create account

Free Starter plan — no credit card.

Dashboard

API keys, usage, and account settings.

OpenAPI

Machine-readable specification (hosted with these docs).

Getting started

Discovery

Historical

Reference

Quick start

First time here?

What you can build

Market discovery

Price history

Liquidity analytics

Order book depth

Coverage

Data model

Design principles

Links

Create account

Dashboard

OpenAPI

​Quick start

First time here?

​What you can build

Market discovery

Price history

Liquidity analytics

Order book depth

​Coverage

​Data model

​Design principles

​Links

Create account

Dashboard

OpenAPI

Quick start

What you can build

Coverage

Data model

Design principles

Links