Skip to main content
GET
List events

Query Parameters

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

Group letter, e.g. "A"

Pattern: ^[A-Z0-9]{1,8}$
team
string

FIFA 3-letter country code; matches teamA OR teamB.

Pattern: ^[A-Z]{3}$
tag
string

Single tag slug, exact match (e.g. "premier-league").

from
string<date-time>

ISO-8601 lower bound on eventStartTime.

to
string<date-time>

ISO-8601 upper bound on eventStartTime.

sort
enum<string>

trending = 24h volume DESC; ending_soon = non-past closesAt ASC (hides already-closed); starting_soon = future kickoff ASC (hides already-started); live = kickoff passed AND a market is still OPEN, most-recently-started DESC. starting_soon / live use per-market kickoff as the authoritative time; the event-level eventStartTime is only a fallback when kickoff is NULL. Default (no sort): earliest public-market kickoff ASC, then title ASC, then event id ASC.

Available options:
trending,
ending_soon,
starting_soon,
live
vertical
string[]

Vertical slug(s) — see GET /api/verticals. crypto selects crypto markets. Open set: an unknown slug matches nothing; soccer is folded to football. Repeated keys or CSV, ≤20 values.

asset
string[]

Crypto coin slug(s) — data-driven (btc, eth, …), plus the reserved others (crypto markets with no identifiable asset). A well-formed but unknown slug matches nothing (200, empty list); a MALFORMED slug returns 400 invalid_asset. Repeated keys or CSV, ≤20 values.

cadence
enum<string>[]

Crypto window cadence slug(s). CLOSED set — an unknown value returns 400 invalid_cadence. Matches events carrying at least one windowed market of that cadence. Repeated keys or CSV, ≤20 values.

Available options:
15-minute,
hourly,
daily,
weekly,
monthly,
annual

Response

200 - application/json

OK

events
any[]
required