Kalshi Endpoints
Kalshi Events API
Use events when your user starts with a topic and needs grouped Kalshi markets rather than individual outcome contracts.
Get Kalshi events
List Kalshi-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/kalshi/events?search=nyc+mayor&limit=5' \
-H 'X-API-Key: YOUR_TPM_API_KEY'Response
{
"events": [
{
"event_ticker": "KXMAYORNYCPARTY-25",
"event_slug": "nyc-mayor-2025",
"title": "NYC Mayor Race 2025",
"category": "politics",
"status": "active",
"volume_total": 18261146.0,
"market_count": 1,
"markets": [
{
"event_ticker": "KXMAYORNYCPARTY-25",
"volume_total": 18261146.0,
"outcomes": [
{ "market_ticker": "KXMAYORNYCPARTY-25-D", "title": "Will a Democrat win?", "probability": 0.89 }
]
}
]
}
],
"total": 1,
"limit": 5,
"offset": 0
}Query Parameters
| Name | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| event_ticker | string | No | - | KXMAYORNYCPARTY-25 | Filter by one or more Kalshi event tickers. |
| search | string | No | - | nyc mayor | Search Kalshi-backed event titles. |
| status | active | closed | resolved | all | No | active | active | Return events by lifecycle status. |
| category | string | No | - | politics | 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 | 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 |
|---|---|---|---|
| event_ticker | string | KXMAYORNYCPARTY-25 | Kalshi event ticker. |
| volume_total | number | - | Sum of known volume for the event. |
| market_count | integer | - | Number of markets in this event group. |
| 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.