Polymarket data methodology and sources
Reviewed November 12, 2026. Polyfun provides free browsing and downloadable samples of historical Polymarket BTC and ETH five-minute Up/Down markets. The public sample collection is smaller than the full recorded archive.
What does five-minute data mean?
Five minutes is the duration of a market round, not the interval between recorded rows. A CSV file contains repeated Up and Down price observations within one round. Actual sampling intervals vary with network latency and API response times; use the timestamp column to measure them.
Where does the data come from?
Our recorders discover market and outcome-token metadata through the Polymarket Gamma API and request outcome-token quotes from the CLOB price endpoint. Price CSVs contain observed quotes, rather than a trade-by-trade execution feed or the spot price of Bitcoin or Ethereum. BTC orderbook JSONL files contain bid and ask depth snapshots for the Up and Down tokens.
Source references: Polymarket API documentation, Gamma API, and CLOB API. This is an independent archive, unaffiliated with Polymarket.
How should timestamps be interpreted?
The numeric timestamp is Unix time in seconds and can contain a fractional component. Convert it to UTC for comparisons. The datetime string in price CSVs is recorded in UTC+8. The five-minute market slug suffix identifies the scheduled start; the scheduled end is 300 seconds later. Confirm the relationship with timestamp and remaining_minutes when importing files.
What are the research limitations?
Recorder downtime, request failures and filtering can leave missing rounds or gaps inside a file. Collection start dates differ by asset and data type. Archive totals describe captured files, not a guarantee that every possible market round is present. Up and Down quotes need not sum to exactly one.
A final recorded quote is an observation, not an independently verified settlement label. Verify official resolution before treating inferred winners as ground truth. Backtests also need fees, spread, available size and execution assumptions; recorded quotes do not establish that an order would have filled.
Which site should I use?
PredictionTicks provides dataset coverage statistics, daily pages, schema documentation, free evaluation samples and a paid complete archive. Check its pricing and license before purchase.