ResourcesFree dataset

Free sample

Free Polymarket BTC 5-Min Historical Order Book Dataset

A real resolved Bitcoin Up/Down market from the PolyOrderBooks archive, with historical L2 bid and ask snapshots captured at 1-second resolution. Download the sample as CSV or JSON — no API key or signup required.

Snapshots600
Resolution1s · captured every second
WinnerYes
AccessNo signup

What's included

One resolved 5-minute BTC Up/Down market — 300 one-second timestamps with YES and NO order books at each second (600 outcome snapshots total).

MarketBitcoin Up or Down - August 13, 12:50AM-12:55AM ET
Slugbtc-updown-5m-1786596600
WindowAug 13, 04:50–04:55 UTC
Resolution1-second historical captures
Snapshots300 Yes + 300 No (600 total)
FormatsCSV 809.4 KB · JSON 3.2 MB

Data methodology

PolyOrderBooks captures and stores Polymarket order books at 1-second resolution. This sample covers one complete resolved BTC 5-minute market and includes the YES and NO order books for each second of the market window.

Each snapshot preserves the visible L2 bid and ask ladders available at that timestamp. Best bid, best ask, spread, midpoint, and visible bid/ask depth are derived directly from those stored ladders.

File previews

First rows from each export — download the full files above.

CSV809.4 KB
timestamp,outcome,best_bid,best_ask,spread,mid_price,bid_depth,ask_depth,bid_levels,ask_levels
2026-08-13T04:50:00Z,Yes,0.47,0.48,0.01,0.475,12100.62,11546.71,47,49
2026-08-13T04:50:01Z,Yes,0.47,0.48,0.01,0.475,12100.62,11546.71,47,49
2026-08-13T04:50:00Z,No,0.52,0.53,0.01,0.525,11546.71,12100.62,49,47
… 597 more rows in the full file
JSON3.2 MB
{
  "metadata": {
    "slug": "btc-updown-5m-1786596600",
    "question": "Bitcoin Up or Down - August 13, 12:50AM-12:55AM ET",
    "resolution": "1s",
    "winner": "Yes"
  },
  "data": {
    "Yes": [
      {
        "t": "2026-08-13T04:50:00Z",
        "bids": [
          [
            0.47,
            67.3
          ],
          [
            0.46,
            144
          ],
          [
            0.45,
            73
          ]
        ],
        "asks": [
          [
            0.48,
            18.3
          ],
          [
            0.49,
            175.15
          ],
          [
            0.5,
            189.99
          ]
        ]
      }
    ],
    "No": [
      "… 300 snapshots per outcome in the full file"
    ]
  }
}

Schema

CSV columns below. JSON uses the same fields under data.Yes[] / data.No[] with t, bids, and asks. Historical fields are stored with each capture; summary columns are derived from the visible ladders at export time.

FieldDefinition
timestampUTC capture time (ISO-8601) at 1-second resolution — stored historical field
market_slugPolyOrderbooks / Polymarket market slug — stored historical field
market_questionHuman-readable market title — stored historical field
outcomeOutcome label (`Yes` or `No`) — stored historical field
token_idPolymarket CLOB token identifier — stored historical field
bid_levelsFull visible bid ladder as JSON `[[price, size], …]` — stored historical field
ask_levelsFull visible ask ladder as JSON `[[price, size], …]` — stored historical field
best_bidHighest visible bid price — derived from bid_levels
best_askLowest visible ask price — derived from ask_levels
spreadBest ask minus best bid — derived from bid_levels and ask_levels
mid_priceMidpoint between best bid and best ask — derived from bid_levels and ask_levels
bid_depthSum of visible bid sizes — derived from bid_levels
ask_depthSum of visible ask sizes — derived from ask_levels

Example rows

Real snapshots from the exported file (summary columns).

TimestampOutcomeBest bidBest askSpreadMidBid depthAsk depthLevels
2026-08-13T04:50:00ZYes0.470.480.010.47512100.6211546.7147 / 49
2026-08-13T04:50:01ZYes0.470.480.010.47512100.6211546.7147 / 49
2026-08-13T04:50:00ZNo0.520.530.010.52511546.7112100.6249 / 47
2026-08-13T04:50:01ZNo0.520.530.010.52511546.7112100.6249 / 47

What can you use it for?

  • Strategy backtests

    Test short-horizon crypto Up/Down ideas against real depth instead of mid-price fills.

  • Spread analysis

    Track bid–ask spread and midpoint drift across a complete 5-minute window.

  • Liquidity research

    See how visible depth and ladder shape change as the market approaches resolution.

  • Execution modeling

    Size limit orders against actual price levels and cumulative depth.

  • Schema validation

    Inspect the PolyOrderbooks data schema before integrating the API.

  • Microstructure studies

    Explore Polymarket BTC interval markets with full L2 snapshots.