linyan1106/polymarket-historical-market-data
Polymarket Crypto Up/Down Historical Market Data This is a data-only research snapshot. It contains no trading bot source code, private strategy, model, signal, backtest ranking, wallet, account, or server log. Contents Official Polymarket market catalog and settlement winner labels. Public minute-level Polymarket token price history. Public Polymarket trades for the explicitly documented subset. Public 1-minute spot candles used for point-in-time market… See the full description on the dataset page: https://huggingface.co/datasets/linyan1106/polymarket-historical-market-data.
Polymarket Crypto Up/Down Historical Market Data
This is a data-only research snapshot. It contains no trading bot source code, private strategy, model, signal, backtest ranking, wallet, account, or server log.
Contents
- Official Polymarket market catalog and settlement winner labels.
- Public minute-level Polymarket token price history.
- Public Polymarket trades for the explicitly documented subset.
- Public 1-minute spot candles used for point-in-time market research.
- Completeness status for odds and public-trade partitions.
Snapshot totals:
- Market rows: 580,287
- Spot candle rows: 3,167,208
- Odds rows: 17,888,930
- Public trade rows: 195,439,081
- Published Parquet files: 708
- Published bytes: 8,937,250,679
Important execution warning
Historical token price points are not historical bid/ask or order-book snapshots. They must not be treated as guaranteed executable prices. Public trades also do not reconstruct every resting order. Any execution backtest should model latency, fees, adverse price movement, volume participation, partial fills and no-fills.
Coverage
The market catalog and odds history cover the configured BTC, ETH, SOL, XRP, HYPE, DOGE and BNB profiles across 5m, 15m, 1h and 4h where the public source returned data. Spot history for HYPE begins later than the other assets and was not fabricated for missing periods.
The public-trade directory is a research subset, not a complete trade archive for every catalog market. Use metadata/manifest.parquet and the published status tables to determine exact coverage. Markets marked truncated=true, api_capped=true or with a non-empty error are not complete and should be excluded from exact execution replay.
Time convention
All stored timestamps are Unix seconds in UTC. Partition month names use UTC. Researchers reporting daily performance should state their own calendar boundary; the originating project uses Asia/Shanghai 00:00 by default.
Data layout
data/markets/markets.parquet
data/spot/<source>/<symbol>/1m/<YYYY-MM>.parquet
data/polymarket/odds/<profile>/<YYYY-MM>.parquet
data/polymarket/odds_status/<profile>/<YYYY-MM>.parquet
data/polymarket/trades/<profile>/<YYYY-MM>.parquet
data/polymarket/trade_status/<profile>/<YYYY-MM>.parquet
metadata/manifest.parquet
metadata/SHA256SUMSProvenance and terms
The files are a normalized compilation of public market information retrieved from Polymarket and public spot-market sources. Upstream providers retain their respective rights. Users are responsible for complying with upstream terms and applicable law. See DATA_TERMS.md before redistribution or commercial use.
