API Overview

polynode API reference. Real-time streaming, historical data, P&L analytics, market data, and more.

The polynode API provides two main surfaces:

1. 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.

2. 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
}

Values like 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

Pagination

All list endpoints support:

• ?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.

Response format

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.