Events - Arbiter

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:

Platform	Grouping Field	Example
Polymarket	`events[].slug` from Gamma API	`presidential-election-winner-2028`
Kalshi	`event_ticker`	`kxnewpope-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