v56

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

Fetch Events Paginated

Paginated variant of {@link fetchEvents}. On the first call (no cursor), all events are fetched from the exchange and cached in an in-memory snapshot. A cursor is returned along with the first page. Subsequent calls with that cursor serve additional pages directly from the cached snapshot -- no additional API calls are made. The snapshot is invalidated after snapshotTTL ms (configured via ExchangeOptions in the constructor). A request using a cursor from an expired snapshot throws 'Cursor has expired'.

get/api/{exchange}/fetchEventsPaginated

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

limitnumber
cursorstring
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"].

Response

Fetch Events Paginated response

successboolean

Example response

{
  "success": true
}