Polymarket Endpoints
Polymarket Events API
Use events when your user starts with a topic and needs grouped markets rather than individual outcome contracts.
Get Polymarket events
List Polymarket-backed event groups with nested market summaries. Use this first when users search for a topic.
Live GET Request
Try it
Live Response
Click Try It to run this GET request against the API.Request
curl 'https://api.thepredictionmarkets.com/api/v2/polymarket/events?search=nba&limit=5' \
-H 'X-API-Key: YOUR_TPM_API_KEY'Response
{
"events": [
{
"event_slug": "2026-nba-champion",
"title": "2026 NBA Champion",
"category": "sports",
"status": "active",
"volume_fiat_amount": 310498252.36,
"market_count": 1,
"markets": [
{
"market_slug": "2026-nba-champion",
"volume_total": 310498252.36,
"outcomes": [
{ "title": "Oklahoma City Thunder", "probability": 0.495 }
]
}
]
}
],
"total": 120
}Query Parameters
| Name | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| event_slug | string | No | - | 2026-nba-champion | Filter by one or more TPM event slugs. |
| search | string | No | - | nba | Search Polymarket-backed event titles. |
| status | active | closed | resolved | all | No | active | active | Return events by lifecycle status. |
| category | string | No | - | sports | Filter by TPM category slug. |
| limit | integer | No | 25 | 5 | Number of event groups to return. Maximum 100. |
| offset | integer | No | 0 | 0 | Offset for pagination. |
| sort | volume | volume_24h | liquidity | updated_at | end_time | created_at | No | volume | volume | Sort by aggregate market activity or recency. |
| order | asc | desc | No | desc | desc | Sort direction. |
Response Fields
| Field | Type | Example | Description |
|---|---|---|---|
| events.event_slug | string | 2026-nba-champion | TPM event slug. |
| events.volume_fiat_amount | number | - | Sum of known volume for the event. |
| events.market_count | integer | - | Number of markets in this event group. |
| events.markets | object[] | - | Nested market summaries. |
| total | integer | - | Total results for pagination. |
Build with TPM
Get your API key
Start with Kalshi and Polymarket market data, then add unified spreads, signals, alerts, and watchlists as your workflow grows.