KAkairos
Sports

Upcoming (not-yet-live) sports events within a time window

Returns fixtures in the requested league set whose scheduled start falls within windowHours, together with primary markets, combo eligibility where available, and cross-venue matches for Polymarket, Kalshi, Predict.fun, and Hyperliquid. Provider-only fixtures may be returned as standalone events. Served from a shared server cache rebuilt about every minute; a copy is never more than two hours old for the default 720h/200 and 168h/12 windows, which are kept warm, or ten minutes old for any other window; the Age header gives the seconds since the body was built. startFrom/startTo return one slice of the window by start time, for loading a schedule a few days at a time. Returns 502 when no provider can supply data and 504 when a cold build runs out of time.

get/sports/upcoming-events

Request

  • Base URL
    https://data.kairos.trade
  • Auth
    none required

Query parameters

windowHoursinteger

Look-ahead window, in hours, for upcoming game start times.

categorystring

Sports-catalog category id (e.g. "basketball"). Expands to every league slug in that category and takes priority over league/series.

leaguestring

Single league slug filter (e.g. "nba"). Used only if category is not supplied or does not resolve.

seriesstring

Comma-separated league slugs. Used only if neither category nor league resolves.

limitPerSeriesinteger

Maximum number of events fetched per resolved series.

startFromstring date-time

Only events starting at or after this instant (ISO 8601 with a UTC offset). startingEvents are included only in the slice that covers the current time, and matchingMarkets only holds entries for the events returned.

startTostring date-time

Only events starting before this instant (ISO 8601 with a UTC offset). Must be after startFrom.

Response

Upcoming events within the window, plus matched cross-provider markets. Returns {"events": [], "startingEvents": [], "matchingMarkets": {}} on a genuine no-data result.

matchingMarketsobject required

Example response

{
  "events": [
    {
      "eventId": "10078222",
      "title": "Lakers at Celtics",
      "sport": "soccer",
      "sportFamily": "soccer",
      "league": "uel",
      "teamA": "Los Angeles Lakers",
      "teamB": "Boston Celtics",
      "marketsCount": 4,
      "eventSlug": "nba-lal-bos-2026-01-15"
    }
  ],
  "startingEvents": [
    {
      "eventId": "10078222",
      "title": "Lakers at Celtics",
      "sport": "soccer",
      "sportFamily": "soccer",
      "league": "uel",
      "teamA": "Los Angeles Lakers",
      "teamB": "Boston Celtics",
      "marketsCount": 4,
      "eventSlug": "nba-lal-bos-2026-01-15"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.