Skip to main content

​
What are Events?

An event groups related markets under a single real-world occurrence. For example, the “2026 FIFA World Cup Winner” event contains 42 individual markets — one for each country. 
{
  "slug": "2026-fifa-world-cup-winner-595",
  "title": "2026 FIFA World Cup Winner",
  "status": "open",
  "market_count": 42,
  "total_volume_24h": 6810039,
  "platforms": ["polymarket"],
  "markets": [
    { "question": "Will England win the 2026 FIFA World Cup?", "volume_24h": 536516 },
    { "question": "Will Argentina win the 2026 FIFA World Cup?", "volume_24h": 372866 },
    ...
  ]
}

​
Event Sources

Events are derived from upstream platform groupings:
PlatformGrouping FieldExample
Polymarketevents[].slug from Gamma APIpresidential-election-winner-2028
Kalshievent_tickerkxnewpope-70

​
Querying Events

# List top events by volume
curl .../v1/events?limit=10

# Search events
curl ".../v1/events?q=world+cup"

# Filter by platform
curl ".../v1/events?platform=polymarket&min_volume=100000"

# Get a specific event with all child markets
curl .../v1/events/2026-fifa-world-cup-winner-595