120-Day BTC 1h Polymarket Historical Data API
Query 120 days of BTC 1h Polymarket history through an API built for paginated snapshots, filtering, and market replay.
120-day BTC 1h Polymarket historical data api gives traders and researchers a rolling multi-month sample of Bitcoin Up/Down markets. PolyHistorical captures full-depth order book snapshots at 300ms granularity, so API workflows can account for spread, liquidity, and the prices that were available at each point in a market.
A complete 120-day calendar window can contain up to roughly 2,880 scheduled 1h windows before launch dates, feed gaps, or unavailable markets are considered. Always measure the returned coverage instead of assuming every possible window exists.
Why Use a 120-Day Window?
Hourly contracts expose wider volatility regimes and give signals more time to interact with changing spreads and depth. A 120-day lookback is long enough to compare multiple volatility and liquidity regimes while remaining practical for rolling research and repeated model validation.
API Workflow for a 120-Day Pull
Start by listing BTC 1h markets inside the required date range. Store the market and token identifiers, then request snapshots in bounded pages and checkpoint the last timestamp after each response. This makes a long backfill resumable instead of relying on one oversized request.
- Filter the market list by coin, interval, and time range.
- Request historical snapshots for each returned market.
- Paginate in chronological order and persist a cursor or timestamp.
- Validate both outcome books before building derived features.
See the PolyHistorical API documentation for the current endpoint and pagination contract.
Quality Checks Before Analysis
Historical depth is only useful when the sample is auditable. Check that timestamps are ordered, both outcome tokens are present, price levels are valid, and market resolution is known. Flag snapshot gaps instead of forward-filling across them, because invented book states can create fills that never existed.
For strategy work, avoid using midpoint as an execution price. A midpoint is descriptive; an order must interact with the bid or ask and may consume several levels when the requested size is larger than top-of-book liquidity.
120 Days vs 90 Days
Choose 120 days when that window matches your compute budget or validation schedule. The 90-day BTC 1h historical data api page covers the shorter alternative. Using both as rolling horizons can show whether a result is stable or overly dependent on the most recent regime.
Which Plan Covers 120 Days?
Pro tops out at 90 days, so a 120-day window is covered by Suite: $41/month for the full archive of BTC, ETH and SOL markets since August 2026, with no history limit, plus Parquet downloads and the Backtest AI Agent. The archive grows every day, so your history only gets longer. You can test the same data format free on recent BTC markets before upgrading.
At 300ms capture, one 1h market can hold up to about 12,000 order book snapshots, so a full 120-day BTC 1h window is up to roughly 34,560,000 snapshots.