Sports

Season/tournament futures markets across sports

Returns futures-style (non-per-game) sports markets for providers Polymarket and Predict.fun (open/active status only). Per-match/per-game rows are excluded; each event is classified into a (category, league) pair from a large token/phrase table, falling back to an "other" bucket, and titles that look like props/game lines/drafts or, for the "other" bucket only, non-sport mis-tags are dropped. Each event is capped at 30 outcomes (highest-priced first, unpriced sink to the bottom); the "other" bucket is additionally capped at 150 events (richest-first); recognized-sport events are uncapped. Results are sorted by market count descending. Responses are served from a cache kept warm in the background. With no parameters the whole list is returned; mode, category, providers and q filter it, and limit switches to pages carrying total and nextOffset.

get/sports/futures

Request

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

Query parameters

mode'sports' | 'esports'

sports leaves out esports and the "other" bucket unless category names one; esports keeps only esports futures and filters category by title.

categorystring

all, a catalog category id (e.g. basketball, other), or with mode=esports an esports title slug or __esports_other for titles outside the catalog.

providersstring

Comma-separated provider names to keep (e.g. polymarket,predictfun).

qstring

Space-separated terms that must all appear in the event title or a contender label.

offsetinteger

Position in the filtered list to start from; use the previous page's nextOffset.

limitinteger

Page size. When set, the response carries total and nextOffset.

Response

Futures/outright markets grouped by event, each with its priced outcomes.

totalinteger

Futures matching the filters across every page. Present only when limit is set.

nextOffsetinteger nullable

offset for the next page, or null on the last. Present only when limit is set.

Example response

{
  "futures": [
    {
      "eventId": "10088234",
      "title": "Super Bowl LX Winner",
      "sport": "football",
      "sportFamily": "football",
      "league": "nfl",
      "volume": 842311,
      "outcomes": [
        {
          "label": "Kansas City Chiefs",
          "price": 0.18,
          "marketId": "10088235"
        }
      ],
      "marketsCount": 32
    }
  ]
}

Changes

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