Skip to main content
GET
/
api
/
events
List events
curl --request GET \
  --url https://core.api.dev.predictstreet.sde.adifoundation.ai/api/events
{
  "events": [
    "<unknown>"
  ]
}

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

Response

200 - application/json

OK

events
any[]
required