Skip to main content
Base URL: https://api.polymarketdata.co Authenticate every /v1 call with X-API-Key. Each route below is its own reference page — parameters, responses, and the playground come from https://api.polymarketdata.co/openapi.json. Do not add per-endpoint MDX files.

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.

​
Shared history query parameters

These appear on every prices, metrics, and books route:

​
Formats

History endpoints return JSON only. Discovery endpoints are also JSON.
After the API spec changes, trigger a Mintlify deploy so each route page picks up the new document. Hide an operation from this sidebar with x-hidden: true in the spec.