https://api.polymarketdata.co
Authenticate every /v1 call with X-API-Key.
Authentication
X-API-Key header, 401s, and plan 403s.Data model
Series, events, markets, and tokens before you pull history.
Errors and limits
Rate limits, lookback windows, and validation errors.
Python SDK
Same surface as typed methods and iterators.
Utility
GET /v1/health
Authenticated liveness check.
GET /v1/usage
Plan, rate-limit remaining, and allowed data points.
Discovery
GET /v1/series
List series (NBA, US Politics, …).
GET /v1/events
List events inside a series.
GET /v1/markets
List markets and their tokens.
GET /v1/markets/{id_or_slug}
One market, including resolution and tokens.
GET /v1/tags
Unique tags for discovery filters.
History
GET /v1/markets/{id_or_slug}/metrics
Volume, liquidity, and spread.
GET /v1/markets/{id_or_slug}/prices
Prices for every token in a market.
GET /v1/tokens/{token_id}/prices
Prices for a single token.
GET /v1/markets/{id_or_slug}/books
L2 books for every token in a market.
GET /v1/tokens/{token_id}/books
L2 book for a single token.