> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arbiterapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Events

> Markets grouped by real-world events.

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

```json theme={null}
{
  "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

```bash theme={null}
# 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
```