API Reference
List Categories
Public: Get available market categories with counts.
Returns categories derived from cached events, with event counts and metadata for each category. Used by frontend for category filtering.
GET
List Categories
Response
200 - application/json
Successful Response
Previous
List EventsPublic: List events with their markets (event-first data structure).
This endpoint provides the Polymarket-style event->markets hierarchy,
preserving the grouping from the Gamma API. Each event contains:
- event_group_id: Unique ID for the event
- event_title: Display title (e.g., "2028 Democratic Presidential Nomination")
- event_image: URL for event thumbnail
- markets: List of markets within this event, each with live prices
- total_volume: Sum of all market volumes
- market_count: Number of markets in this event
- is_hot: Whether this event has significant trading activity
Query params:
- limit: Max events to return (default 50)
- offset: Pagination offset
- hot_only: Only return events with significant volume
- markets_per_event: Max markets per event (default 20, for bandwidth)
- category: Filter by detected category (Sports, Politics, Crypto, etc.)
- search: Text search in event titles and market questions (searches sports too)
- include_sports: Whether to include sports games in search results (default true)
Next
List Categories