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.
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).
btc-updown-5m-1786596600Data 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.
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
{
"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.
| Field | Definition |
|---|---|
timestamp | UTC capture time (ISO-8601) at 1-second resolution — stored historical field |
market_slug | PolyOrderbooks / Polymarket market slug — stored historical field |
market_question | Human-readable market title — stored historical field |
outcome | Outcome label (`Yes` or `No`) — stored historical field |
token_id | Polymarket CLOB token identifier — stored historical field |
bid_levels | Full visible bid ladder as JSON `[[price, size], …]` — stored historical field |
ask_levels | Full visible ask ladder as JSON `[[price, size], …]` — stored historical field |
best_bid | Highest visible bid price — derived from bid_levels |
best_ask | Lowest visible ask price — derived from ask_levels |
spread | Best ask minus best bid — derived from bid_levels and ask_levels |
mid_price | Midpoint between best bid and best ask — derived from bid_levels and ask_levels |
bid_depth | Sum of visible bid sizes — derived from bid_levels |
ask_depth | Sum of visible ask sizes — derived from ask_levels |
Example rows
Real snapshots from the exported file (summary columns).
| Timestamp | Outcome | Best bid | Best ask | Spread | Mid | Bid depth | Ask depth | 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 |
| 2026-08-13T04:50:01Z | No | 0.52 | 0.53 | 0.01 | 0.525 | 11546.71 | 12100.62 | 49 / 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.