> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oddpool.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Polymarket historical data

> Historical orderbook snapshots, top-of-book timeseries, and trade data for Polymarket markets.

<Note>Available on all plans (Free tier included).</Note>

Historical orderbook snapshots, top-of-book timeseries, and trade data for Polymarket markets. Data available from **March 20, 2026** onward. Returns native Polymarket data with asset IDs, bids/asks, and condition IDs. Data becomes available approximately one hour after it occurs.

<Info>
  Polymarket markets have two tokens (YES and NO) per condition. Each snapshot row is for a single token. Use the `asset_id` parameter to filter to a specific token, or omit it to get both.
</Info>

## What you can build

* **Backtesting:** replay historical orderbooks and trades to validate trading strategies before deploying capital
* **Price charts:** build custom candlestick or mid-price charts from top-of-book snapshots
* **Liquidity analysis:** measure how bid/ask depth and spreads change around major events like elections or economic releases
* **Execution quality:** compare your historical fills against the orderbook at time of execution to measure slippage
* **On-chain trade analysis:** correlate trade flow with on-chain activity using `transaction_hash` and `fee_rate_bps` fields
* **Market making research:** study spread dynamics and depth profiles to calibrate quoting strategies

## Pagination

All historical endpoints use cursor-based pagination. Pass `pagination_key` from the previous response to get the next page.

```json theme={null}
{
  "pagination": {
    "limit": 100,
    "count": 100,
    "has_more": true,
    "pagination_key": "eyJo..."
  }
}
```