Polymarket
Markets, the recorded order book and its Parquet archive, outcome candles, trader profiles, smart money and on-chain settlements.
Polymarket markets and their on-chain settlements, the recorded order book and event tape, outcome candles, trader
profiles, the leaderboard and smart money, over the /v1/polymarket routes, plus whole days of the book
as Parquet files.
What it answers
Each recipe answers one question with a call you can copy and a real response. All recipes lists every one by number.
The data behind it
| Dataset | Kind | What it holds |
|---|---|---|
| Order-book events | data | The full L2 tape — book snapshots, price_change deltas, trades, tick-size and status markers. |
| Trades | data | The taker tape alone — trade prints without the book. |
| Top-of-book quotes | data | Derived top of book — bid, ask and both sizes, one row per change. |
| Markets & settlements | data | Market search, one-market detail, and the on-chain resolution per condition. |
| Smart money | analytics | Markets where the smart-money cohort is net buying, and where it bought below the current mid. |
| Wallet profile | analytics | One trader's lifetime volume, realized PnL, hit rate, open positions and PnL curve. |
| Wallet leaderboard | analytics | Polymarket wallets ranked by realized P&L, hit rate, volume or trade count, for all time or a window, optionally within one market category; the board is rebuilt hourly. |
Whole days of the book, the trades and top-of-book quotes come as Parquet files: Parquet archive.
Endpoints
| Endpoint | Request | What it returns |
|---|---|---|
| Markets | GET /v1/polymarket/markets | Search/filter recorded markets. |
| One market | GET /v1/polymarket/markets/{condition_id} | One market by condition_id, as an ARRAY of 0 or 1 rows. |
| Market stats | GET /v1/polymarket/market_stats | Event counts, trade volume and first/last timestamps for one token. |
| Outcome candles | GET /v1/polymarket/ohlcv | Bars at a fixed interval, OLDEST first. |
| Order-book snapshot | GET /v1/polymarket/orderbook | The nearest book snapshot at or before ts, flattened to levels. |
| Settlements in bulk | GET /v1/polymarket/settlements/bulk | On-chain settlements, oldest resolution first, ordered (resolved_ts_ms, condition_id). |
| Settlement of one market | GET /v1/polymarket/settlements/{condition_id} | The ON-CHAIN resolution row for one market, as an array of 0 or 1 rows. |
| Trader profile | GET /v1/polymarket/wallets/{address} | A Polymarket wallet's profile: lifetime volume and trade counts, realized P&L and hit rate over window (by RESOLUTION time), markets, recent trades, open positions and an equity curve. |
| Smart-money signals | GET /v1/polymarket/smart_money | flows: markets with the largest net inflow from the smart-money cohort over the window. |
| Trader leaderboard | GET /v1/polymarket/leaderboard | The wallet leaderboard: Polymarket wallets ranked by realized P&L, hit rate, volume or trade count, as an ARRAY of rows (an empty array means no wallet passes the filters). |
| Event tape | GET /v1/polymarket/events | The raw per-market event tape, ordered (local_ts, seq, token_id). |
| Archive file index | GET /v1/polymarket/archive/datasets | Every known archive Parquet file, filtered and paged, in MANIFEST ORDER. |
| Archive file URL | GET /v1/polymarket/archive/url | Resolve exactly ONE dataset to its download URL. |
What every route in this namespace shares, including its own error bodies, is on Polymarket endpoints.
Before you rely on it
Before you rely on it lists what the field names do not tell you, and Data model explains condition and token ids, event rows and settlement.