List Future Markets

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):

ParameterKindMeaning
with_markets_fromresult filterOnly futures with a priced, tenant-visible quote from at least one listed venue.
sourcesquote filterWith include_outcomes=true, only the listed venues' quotes in outcomes[].odds[]; the futures returned do not change.
aggregatoraliasAlias 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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Filter by league ID — accepts a UUID or league abbreviation (e.g., 'NFL', 'NBA')

string

Filter by tournament ID (UUID)

string

Filter by market type ID (UUID)

string

Filter by future type (e.g., 'tournament_outright', 'season_total')

integer

Filter by season year. A future market has no season column, so this matches the season token of its canonical family key (future|<league>|<season>|<type>|<subject>, e.g. future|nba|2027|championship|league is season 2027). Markets without a family key never match. The token is the classifier's own season, not derived from start_date.

string

Comma-separated venue keys (kalshi, limitless, polymarket, polymarket_us, predict_fun, prophetx, sxbet). Only futures that currently have a priced, tenant-visible quote from at least one of them. Applied before pagination, so x-total-count describes the filtered set. A venue the tenant cannot see matches nothing. Cannot be combined with aggregator.

string

Comma-separated venue keys (kalshi, limitless, polymarket, polymarket_us, predict_fun, prophetx, sxbet). Keeps only those venues' quotes in outcomes[].odds[] (and the venue-keyed outcomes[].execution); the futures and outcomes returned do not change, and an outcome with no remaining quote keeps odds: []. tradeable/untradeable_reasons are judged on every tenant-visible quote, not the filtered ones, and outcomes[].metadata is passed through unfiltered. Requires include_outcomes=true (400 otherwise).

string
enum
deprecated

Alias of with_markets_from with a single venue; kept for compatibility, no removal planned. Case-insensitive; spellings such as sx_bet fold like with_markets_from. One value only: a comma-separated list returns 400. Cannot be combined with with_markets_from.

string
enum

Filter by lifecycle. active is a market whose status is active, open or trading; closed is every other status (closed, settled, resolved, or missing), so the two partition the catalog. Judged on the served row.

Allowed:
boolean

Include outcomes and current venue quotes for each market (true/false, default: false)

integer
≥ 1
Defaults to 1

Page number for page/per_page pagination. Do not combine with limit/offset.

integer
1 to 1000
Defaults to 50

Number of items per page (max 1000). Do not combine with limit/offset.

Responses

Callback
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json