Documentation Index
Fetch the complete documentation index at: https://polynode.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
The polynode API provides two main surfaces:
-
V3 Historical Data — query the complete Polymarket V1 + V2 database. 1.2 billion fills, 228 million positions, 2.7 million wallets. Dual P&L (realized + unrealized), position tracking with settlement status, builder analytics, market search, and leaderboards.
-
Real-time Streaming — live WebSocket feeds for settlements, trades, price updates, position changes, and more. See the WebSocket tab.
The V3 endpoints replace the older Onchain V2 endpoints, which are being deprecated. Existing integrations will continue to work during the transition.
V3 Data API — Base URL
https://api.polynode.dev/v3
What’s in the database
Query GET /v3/stats for live counts. Current scale:
| Metric | Count |
|---|
| Fills (trades) | 1+ billion |
| Positions | 200+ million |
| Unique wallets | 2.5+ million |
| Redemptions | 160+ million |
| Splits | 30+ million |
| Merges | 14+ million |
| Markets indexed | 1.07 million |
| Token prices | 2 million |
Key features
- Dual P&L — realized and unrealized profit/loss for every wallet, computed from the full event history using weighted-average cost basis math
- Position status — every position is tagged as
open, closed, redeemable, or redeemed based on live settlement data
- Redeemable payouts — see exactly how much USDC a wallet can claim from resolved markets
- Builder attribution — 77 million fills attributed to 1,502 unique builders
- Batch queries — query up to 100 wallets in a single call
- Time-range filters — filter trades, redemptions, and activity by Unix timestamp
- Market search — full-text search across 1 million+ market questions
Amounts and precision
All monetary amounts are returned in USD as JSON numbers. No conversion needed.
{
"net_realized_pnl": 22053845.825455,
"total_volume": 43013258.515682
}
net_realized_pnl: 22053845.825455 mean $22,053,845.83 USD.
Authentication
The V3 Data API is currently open access with rate limiting per IP. No API key is required.
Timestamps
All Unix timestamps in responses are in seconds (e.g., "1778674056"). The resolved_at field in resolutions uses milliseconds (e.g., "1778674836000"). Datetime strings like updated_at are in UTC.
Rate limits
| Limit | Value |
|---|
| Requests per minute per IP | 200 |
| Max concurrent queries per IP | 5 |
| Max page size | 1,000 rows |
| Query timeout | 10 seconds |
?limit=N — results per page (default 100, max 1000)?offset=N — skip N results
Responses include has_more: true/false to indicate if more pages exist.
Every response includes elapsed_ms showing server-side query time in milliseconds.
{
"data": [...],
"rows_returned": 100,
"has_more": true,
"offset": 0,
"limit": 100,
"elapsed_ms": 12
}
Endpoint categories
| Category | Endpoints | What you can do |
|---|
| Wallet P&L | 4 | Wallet summary, dual P&L breakdown, batch queries, enriched positions |
| Wallet Activity | 6 | Trades, redemptions, splits, merges, NRC, combined activity |
| Markets | 7 | Search, lookup by condition/token/slug, trades, positions, prices |
| Leaderboard | 3 | Global P&L rankings, tag discovery, tag leaderboards |
| Builders | 3 | Builder rankings, stats, attributed trades |
| Global | 5 | Platform stats, trade feed, fees, resolutions, conditions |
| Tokens | 1 | Token price and market metadata |
Explorer
Browse the data interactively with pre-built SQL recipes at explorer.polynode.dev.
