Fetch Events
Fetch events with optional keyword search. Events group related markets together (e.g., "Who will be Fed Chair?" contains multiple candidate markets).
Path parameters
The prediction market exchange to target.
Query parameters
For keyword search
Maximum number of results to return
Opaque venue pagination cursor, where supported.
Pagination offset — number of results to skip
Sort order for results
Filter by event status (default: 'active', 'inactive' and 'closed' are interchangeable)
Where to search (default: 'title')
Direct lookup by event ID
Lookup by event slug
Filter events by their parent series. Accepts the venue-native series id / ticker / slug (e.g. Kalshi "KXATPMATCH", Polymarket "wta"). Passed through to the vendor where supported, otherwise applied to sourceMetadata after fetch.
Optional client-side filter applied after fetching
Filter by category. Each event belongs to a venue-assigned category such as "Sports", "Politics", "Crypto", "Bitcoin", "Soccer", "Economic Policy" (Polymarket) or "Sports", "Mentions" (Kalshi).
Filter by tags. Returns events matching ANY of the provided tags. Tags are more specific than categories -- for example a "Politics" event might carry tags ["Politics", "Geopolitics", "Middle East", "Iran"]. Common tags include "Crypto", "Elections", "Fed Rates", "FIFA World Cup", "Trump".
Filter by source venue (e.g. 'polymarket', 'kalshi', 'myriad'). exchange is an alias.
Alias for sourceExchange.
Response
Fetch Events response
Example response
{
"success": true
}