Events
Get prediction events that group related markets
List Events
GETRetrieve events that group related prediction markets (e.g., "2026 US Presidential Election" contains multiple candidate markets).
GET /api/v1/eventsQuery Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | number | 20 | Results per page (max 100) |
offset | number | 0 | Pagination offset |
exchange | string | - | Filter: POLYMARKET or KALSHI |
category | string | - | Filter by category |
Example
curl -H "Authorization: Bearer or_live_xxx" \
"https://api.tessradar.com/api/v1/events?limit=5"Response
{
"data": [
{
"id": "event-uuid-123",
"title": "2026 US Presidential Election",
"description": "Markets related to the 2026 US presidential race",
"exchange": "POLYMARKET",
"category": "Politics",
"marketCount": 12,
"totalVolume": 45000000,
"imageUrl": "https://...",
"createdAt": "2025-06-01T00:00:00.000Z"
}
],
"pagination": {
"total": 156,
"limit": 5,
"offset": 0,
"hasMore": true
}
}Cost: 1 credit per request
Get Event by ID
GETGet a single event with all its associated markets.
GET /api/v1/events/{id}Path Parameters
| Parameter | Type | Description |
|---|---|---|
id | string | Event UUID |
Example
curl -H "Authorization: Bearer or_live_xxx" \
"https://api.tessradar.com/api/v1/events/event-uuid-123"Response
{
"data": {
"id": "event-uuid-123",
"title": "2026 US Presidential Election",
"description": "Markets related to the 2026 US presidential race",
"exchange": "POLYMARKET",
"category": "Politics",
"totalVolume": 45000000,
"imageUrl": "https://...",
"createdAt": "2025-06-01T00:00:00.000Z",
"markets": [
{
"id": "market-uuid-1",
"question": "Will Trump win the 2026 election?",
"price": 0.42,
"volume24h": 1500000
},
{
"id": "market-uuid-2",
"question": "Will Biden win the 2026 election?",
"price": 0.35,
"volume24h": 1200000
}
]
}
}Cost: 1 credit per request