notkali/polymarket-crypto-5m-15m

---
license: mit
task_categories:
- time-series-forecasting
tags:
- polymarket
- crypto
- prediction-markets
- order-books
- trades
- bitcoin
- ethereum
- solana
- xrp
pretty_name: Polymarket Crypto 5m/15m Market Data
size_categories:
- 100K<n<1M
---

# Polymarket Crypto 5-Minute & 15-Minute Market Data

High-frequency data from Polymarket's crypto up/down prediction markets. Covers **BTC, ETH, SOL, XRP** across 5-minute and 15-minute windows.

Updated daily. All timestamps are **UTC**.

Last updated: 2026-03-13 01:55 UTC

## Data Summary

| Dataset | Rows | First Date | Last Date |
|---------|------|-----------|----------|
| **orderbooks** | 3,415,267 | 2026-01-09 | 2026-03-13 |
| **trades** | 23,241,033 | 2026-01-27 | 2026-03-13 |
| **price_history** | 304,340 | 2026-03-06 | 2026-03-13 |
| **crypto_prices** | 37,480 | 2026-03-06 | 2026-03-13 |
| **markets** | 17,389 | — | — |
| **resolutions** | 17,972 | — | — |

## Subsets

### orderbooks
10-level order book snapshots captured every 10 seconds.

| Column | Type | Description |
|--------|------|-------------|
| timestamp | datetime | Snapshot time (UTC) |
| asset | string | BTC, ETH, SOL, XRP |
| market_id | string | Market slug |
| token_id | string | CLOB token ID |
| best_bid | float | Highest bid price |
| best_ask | float | Lowest ask price |
| spread | float | best_ask - best_bid |
| mid_price | float | (best_bid + best_ask) / 2 |
| bid_levels | json | Top 10 bid levels |
| ask_levels | json | Top 10 ask levels |

### trades
Individual trade executions from the Polymarket Data API.

| Column | Type | Description |
|--------|------|-------------|
| timestamp | datetime | Trade time (UTC) |
| asset | string | BTC, ETH, SOL, XRP |
| market_id | string | Market slug |
| side | string | BUY or SELL |
| price | float | Trade price (0-1) |
| size | float | Trade size in USDC |
| tx_hash | string | Transaction hash |

### resolutions
Final outcomes for resolved markets.

| Column | Type | Description |
|--------|------|-------------|
| market_id | string | Market slug |
| asset | string | BTC, ETH, SOL, XRP |
| resolved_at | datetime | Resolution time (UTC) |
| outcome | string | Up or Down |

### markets
Market metadata and configuration.

### price_history
1-minute price points from CLOB API for Polymarket market tokens.

| Column | Type | Description |
|--------|------|-------------|
| timestamp | datetime | Price time (UTC, rounded to minute) |
| asset | string | BTC, ETH, SOL, XRP |
| market_id | string | Market slug |
| token_id | string | CLOB token ID |
| price | float | Mid-price (0-1) |

### crypto_prices
1-minute OHLCV candles for underlying crypto assets from Binance.

| Column | Type | Description |
|--------|------|-------------|
| timestamp | datetime | Candle open time (UTC) |
| asset | string | BTC, ETH, SOL, XRP |
| open | float | Open price (USD) |
| high | float | High price (USD) |
| low | float | Low price (USD) |
| close | float | Close price (USD) |
| volume | float | Trading volume |
| trade_count | int | Number of trades |

## Usage

```python
from datasets import load_dataset

# Load trades
trades = load_dataset("obadiaha/polymarket-crypto-5m-15m", data_dir="trades")

# Load order books
books = load_dataset("obadiaha/polymarket-crypto-5m-15m", data_dir="orderbooks")

# Load resolutions
resolutions = load_dataset("obadiaha/polymarket-crypto-5m-15m", data_dir="resolutions")

# Load crypto spot prices (1-minute candles)
crypto = load_dataset("obadiaha/polymarket-crypto-5m-15m", data_dir="crypto_prices")
```

## Collection Method

Data is collected by an automated bot running 5 concurrent loops:
- **Order books**: CLOB API `/book` every 10s
- **Trades**: Data API `/trades` every 30s
- **Resolutions**: Gamma API `/markets?closed=true` every 60s
- **Market discovery**: Gamma API `/events/slug/{slug}` every 2 min
- **Price history**: CLOB `/book` every 60s for active market tokens
- **Crypto prices**: Binance `/api/v3/klines` every 60s (BTC, ETH, SOL, XRP 1m candles)

## License

MIT