Skip to main content
GET
Get event by id

Path Parameters

id
string<uuid>
required

Response

OK

Polymarket-style event grouping. One event can hold one or more markets (e.g. a per-team accordion under a single tournament question).

id
string<uuid>
slug
string
title
string
group
string | null

Tournament group letter ("A".."L"). Null for non-fixture events.

stage
enum<string> | null
Available options:
group,
r32,
r16,
quarter_finals,
semi_finals,
third_place,
final
teamA
string | null

FIFA 3-letter country code of the focus side. For 1-vs-1 fixtures both teamA and teamB are set; for tournament-winner markets only teamA is populated; for picker-style multi-outcome markets both are null.

teamB
string | null

FIFA 3-letter country code of the opposing side in 1-vs-1 fixtures.

tags
object[]

Currently-active tags assigned to the event. Filter via /api/events?tag=.

eventStartTime
string<date-time> | null

Real-world fixture kickoff time, separate from createdAt.

createdAt
string<date-time>
updatedAt
string<date-time>
markets
object[]
vertical
string | null

Event vertical — the value /api/events?vertical= accepts (football, crypto, politics, …).

Example:

"crypto"

cryptoSeries
object | null

Short-crypto Up/Down SERIES this event's windows belong to; null on every other event (long-dated crypto events included). One event is created per series per UTC day — ~96 markets at the 15-minute cadence — so navigate GET /api/crypto-series/{id}/windows rather than the event's markets[], which nests only the currently tradeable windows.