Retrieve future markets (tournament outrights, season totals, etc.).
Future markets are separate from event-scoped markets and include:
- Tournament outrights (e.g., "NFL Super Bowl Winner")
- Season totals (e.g., "Team Win Total")
- Player props (e.g., "MVP Winner")
Use include_outcomes=true to include outcomes and their current,
tenant-visible venue quotes for each market in the response.
Discovery flow: GET /sports -> GET /leagues (each league item carries
futures_count) -> GET /futures?league_id=<abbr>&season_year=<year>&with_markets_from=<venue>.
season_year, with_markets_from and status (active|closed) narrow the
list; an unsupported value is a 400, never silently ignored.
Venue parameters (the same names as GET /search):
| Parameter | Kind | Meaning |
|---|---|---|
with_markets_from | result filter | Only futures with a priced, tenant-visible quote from at least one listed venue. |
sources | quote filter | With include_outcomes=true, only the listed venues' quotes in outcomes[].odds[]; the futures returned do not change. |
aggregator | alias | Alias of with_markets_from with one venue; kept for compatibility, no removal planned. |
Send both (with_markets_from=kalshi&sources=kalshi) for "only Kalshi's futures,
showing only Kalshi's prices". Venue keys: kalshi, limitless, polymarket, polymarket_us, predict_fun, prophetx, sxbet. Spellings such
as predictfun, sx_bet or Kalshi fold to these keys; an unknown key is a
400 invalid_parameters whose body lists valid_keys. Combining
with_markets_from with aggregator is a 400.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
