Polymarket API
## The Most Complete Polymarket Data API Access everything from [Polymarket](https://polymarket.com) — the world's largest prediction market — through a single, fast, clean REST API. **25 endpoints** covering every surface of the platform. More than every other Polymarket-only API on RapidAPI. --- ## Key Endpoints | Category | Endpoints | |----------|-----------| | **Markets** | List, get by ID,…
Polymarket API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Markets | ||
| GET |
/api/v1/markets/{id}/trades /api/v1/markets/{id}/trades |
|
| GET |
/api/v1/markets/search /api/v1/markets/search |
Full-text search across the Polymarket catalog. |
| GET |
/api/v1/markets/{id}/holders /api/v1/markets/{id}/holders |
|
| GET |
/api/v1/markets/{id}/orderbook /api/v1/markets/{id}/orderbook |
Bids/asks for a specific outcome. Bids returned descending; asks ascending. |
| GET |
/api/v1/markets/autocomplete /api/v1/markets/autocomplete |
Lightweight wrapper around search optimised for typeahead UIs. |
| GET |
/api/v1/markets/{id}/price-history /api/v1/markets/{id}/price-history |
Time-series of `{timestamp, price}` ticks suitable for charts. |
| GET |
/api/v1/markets/{id}/related /api/v1/markets/{id}/related |
Returns markets that Polymarket considers similar to the given event. |
| GET |
/api/v1/markets/{id} /api/v1/markets/{id} |
Retrieve a market by numeric id, conditionId (0x...), or slug. |
| GET |
/api/v1/markets/{id}/comments /api/v1/markets/{id}/comments |
|
| GET |
/api/v1/markets /api/v1/markets |
Filter, sort and paginate markets. Defaults return active, non-closed markets sorted by 24hr volume. |
| Events | ||
| GET |
/api/v1/events /api/v1/events |
Filter, sort and paginate events. An event groups one or more related markets. |
| GET |
/api/v1/events/trending /api/v1/events/trending |
Active events ranked by 24hr volume. |
| GET |
/api/v1/events/{slug} /api/v1/events/{slug} |
Look up an event by its slug or numeric id. Includes nested markets and AI summary if available. |
| Users | ||
| GET |
/api/v1/users/{address}/value /api/v1/users/{address}/value |
|
| GET |
/api/v1/users/{address}/activity /api/v1/users/{address}/activity |
|
| GET |
/api/v1/users/{address}/positions /api/v1/users/{address}/positions |
|
| GET |
/api/v1/users/{address} /api/v1/users/{address} |
Combines user-stats, traded markets, total volume, PnL and current portfolio value into one call. Accepts wallet address or username. |
| GET |
/api/v1/users/{address}/pnl /api/v1/users/{address}/pnl |
|
| Leaderboard | ||
| GET |
/api/v1/leaderboard /api/v1/leaderboard |
Ranked traders by volume, profit, or biggest single win. |
| Tags | ||
| GET |
/api/v1/tags/{slug} /api/v1/tags/{slug} |
|
| GET |
/api/v1/tags/{slug}/events /api/v1/tags/{slug}/events |
|
| GET |
/api/v1/tags /api/v1/tags |
|
| Misc | ||
| GET |
/api/v1/sports/{league}/teams /api/v1/sports/{league}/teams |
|
| GET |
/api/v1/series /api/v1/series |
Series like "BTC Up or Down 5m" or "ETH Up or Down 4h". |
| GET |
/health /health |
|
Polymarket API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $9.99 / month | — |
|
| ULTRA Recommended | $29.99 / month | — |
|
| MEGA | $99.99 / month | — |
|