Events
Event groups and categories
The Events API provides access to event groups that organize related prediction markets together. For example, a "2026 US Midterm Elections" event might contain markets for individual Senate races, House control, and overall party outcomes. All event endpoints are public.
Endpoints
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/v1/events | Public | List event groups with optional filters |
| GET | /api/v1/events/:slug | Public | Get event detail with its markets |
| GET | /api/v1/events/:slug/chart | Public | Get chart data for event outcomes |
List Events
Fetch a paginated list of event groups.
Query Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
category | string | -- | Filter by category |
status | string | -- | Filter by event status |
limit | number | 50 | Number of results (max 100) |
offset | number | 0 | Offset for pagination |
// GET /api/v1/events?category=politics&limit=10
// Response 200
{
"events": [
{
"id": "clxyz456...",
"slug": "2026-us-midterm-elections",
"title": "2026 US Midterm Elections",
"category": "politics",
"marketCount": 12,
"totalVolume": 5400000.00,
"status": "active",
"imageUrl": "https://..."
}
],
"total": 85
}Event Detail
Get a single event by its slug, including all related markets.
// GET /api/v1/events/2026-us-midterm-elections
// Response 200
{
"id": "clxyz456...",
"slug": "2026-us-midterm-elections",
"title": "2026 US Midterm Elections",
"category": "politics",
"description": "Markets related to the 2026 US Midterm Elections",
"markets": [
{
"id": "clxyz789...",
"title": "Will Democrats win the Senate?",
"yesPrice": 0.42,
"volume": 890000.00
}
],
"totalVolume": 5400000.00,
"status": "active"
}Event Chart
Get chart data showing price history for all outcomes within an event, useful for rendering multi-line comparison charts.
// GET /api/v1/events/2026-us-midterm-elections/chart
// Response 200
{
"outcomes": [
{
"marketId": "clxyz789...",
"title": "Will Democrats win the Senate?",
"dataPoints": [
{ "timestamp": "2026-03-01T00:00:00Z", "price": 0.38 },
{ "timestamp": "2026-03-02T00:00:00Z", "price": 0.42 }
]
}
]
}Notes
- Events are sourced from both Polymarket and Kalshi, with related markets grouped by the ingestion pipeline
- The
slugparameter is a URL-friendly identifier, not the UUID - Returns
404if the event slug is not found