v56

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-215245616.9 KB

Fetch Event

Fetch a single event by lookup parameters. Convenience wrapper around fetchEvents() that returns a single result or throws EventNotFound.

get/api/{exchange}/fetchEvent

Path parameters

exchange'polymarket' | 'kalshi' | 'kalshi-demo' | 'limitless' | 'probable' | 'baozi' | 'myriad' | 'opinion' | 'metaculus' | 'smarkets' | 'polymarket_us' | 'gemini-titan' | 'hyperliquid' | 'suibets' | 'rain' | 'hunch' | 'router' required

The prediction market exchange to target.

Query parameters

querystring

For keyword search

limitnumber

Maximum number of results to return

cursorstring

Opaque venue pagination cursor, where supported.

offsetnumber

Pagination offset — number of results to skip

sort'volume' | 'liquidity' | 'newest'

Sort order for results

status'active' | 'inactive' | 'closed' | 'all'

Filter by event status (default: 'active', 'inactive' and 'closed' are interchangeable)

searchIn'title' | 'description' | 'both'

Where to search (default: 'title')

eventIdstring

Direct lookup by event ID

slugstring

Lookup by event slug

seriesstring

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.

textstring
searchInstring[]

Default: ['title']

categorystring

Filter by category. Common values: "Sports", "Politics", "Crypto", "Bitcoin", "Soccer", "Economic Policy" (Polymarket) or "Sports", "Mentions" (Kalshi).

tagsstring[]

Match events that have ANY of these tags. Examples: ["Crypto"], ["Politics", "Geopolitics", "Middle East"], ["Sports", "FIFA World Cup"].

Optional client-side filter applied after fetching

categorystring

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).

tagsstring[]

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".

sourceExchangestring

Filter by source venue (e.g. 'polymarket', 'kalshi', 'myriad'). exchange is an alias.

exchangestring

Alias for sourceExchange.

Response

Fetch Event response

successboolean

Example response

{
  "success": true
}