https://api.polymarketdata.co
Every
/v1 endpoint requires an API key in the X-API-Key header. Create one in the dashboard.What you can query
Discovery
Find series, events, markets, and tags. Use the returned market ID or slug on history endpoints.
Prices
Token probabilities from 0.0 to 1.0, aggregated to
1m, 10m, 1h, 6h, or 1d.Metrics
Volume, liquidity, and spread time series for a market.
Order books
Historical L2 snapshots as
[price, size] bid and ask levels.Typical workflow
1
Create an API key
Sign in at app.polymarketdata.co and create a key. Send it as
X-API-Key on every request.2
Discover a market
Call
GET /v1/markets (or series and events first). Save the market id or slug.3
Pull history
Query
/v1/markets/{id_or_slug}/prices, /metrics, or /books with start_ts, end_ts, and resolution.Choose your client
Quickstart
First authenticated request in the Python SDK or raw REST.
Python SDK
pip install polymarketdata-sdk with typed methods and auto-pagination.Standard coverage starts in August 2025. Earlier history is available on enterprise plans. Plan limits also control resolution, lookback window, and requests per minute — check
GET /v1/usage if a history call returns 403.