CoolFace
Datasetpublic

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.

sourceHugging Faceotherupdated 2mo agoView on Hugging Face
0likes165downloads
Dataset Card

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

text
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/SHA256SUMS

Provenance 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.