# PolymarketData

> Historical Polymarket market data API: discovery, prices, metrics, and L2 order books.

- [PolymarketData API](https://docs.polymarketdata.co/index.md): Historical Polymarket prices, metrics, and L2 order books for research and backtesting.
- [Quickstart](https://docs.polymarketdata.co/quickstart.md): Authenticate, find a market, and pull one week of minute prices.
- [Authentication](https://docs.polymarketdata.co/authentication.md): Send your dashboard API key in the X-API-Key header on every /v1 request.
- [Data model](https://docs.polymarketdata.co/guides/concepts.md): How series, events, markets, and tokens nest, and which identifiers to persist.
- [Pagination](https://docs.polymarketdata.co/guides/pagination.md): Walk discovery and history pages with metadata.next_cursor.
- [Errors and limits](https://docs.polymarketdata.co/guides/errors.md): Status codes, plan restrictions, and how to handle 429s.
- [Python SDK](https://docs.polymarketdata.co/sdks/python.md): Install polymarketdata-sdk, call discovery and history, and page results with iterators.
- [API overview](https://docs.polymarketdata.co/api-reference/overview.md): Every public PolymarketData route, generated from the live OpenAPI spec.
- [Authenticated liveness check](https://docs.polymarketdata.co/api-reference/utility/authenticated-liveness-check.md): Lightweight liveness check for authenticated clients.
- [Get usage information](https://docs.polymarketdata.co/api-reference/utility/get-usage-information.md): Get current usage information for the authenticated API key.
- [List series](https://docs.polymarketdata.co/api-reference/discovery/list-series.md): List broad categories of prediction markets (e.g., "NBA", "US Politics").
- [List events](https://docs.polymarketdata.co/api-reference/discovery/list-events.md): List specific events within series (e.g., "Lakers vs Bulls", "Iowa Caucus").
- [List markets](https://docs.polymarketdata.co/api-reference/discovery/list-markets.md): List bettable contracts/markets (e.g., "Winner", "Total Points Over/Under").
- [Get market details](https://docs.polymarketdata.co/api-reference/discovery/get-market-details.md): Get detailed information about a specific market by ID or slug.
- [List available tags](https://docs.polymarketdata.co/api-reference/discovery/list-available-tags.md): List all unique event tags available for discovery filtering.
- [Get market metrics history](https://docs.polymarketdata.co/api-reference/history/get-market-metrics-history.md): Get historical market-level metrics including volume, liquidity, and spread.
- [Get market token prices history](https://docs.polymarketdata.co/api-reference/history/get-market-token-prices-history.md): Get historical token prices (probabilities from 0.0 to 1.0).
- [Get token price history](https://docs.polymarketdata.co/api-reference/history/get-token-price-history.md): Get historical prices (probabilities from 0.0 to 1.0) for a specific token.
- [Get market order book history](https://docs.polymarketdata.co/api-reference/history/get-market-order-book-history.md): Get historical order book snapshots for market tokens.
- [Get token order book history](https://docs.polymarketdata.co/api-reference/history/get-token-order-book-history.md): Get historical order book snapshots for a specific token.

## OpenAPI Specs

- [openapi](https://api.polymarketdata.co/openapi.json)
- [openapi](/openapi.json)