API Reference
  1. Sports Stack
  2. Betting

List Future Markets

get
https://api.sportsstack.io/api/v1/futures

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>&aggregator=<venue>.
season_year, aggregator and status (active|closed) narrow the list
the way they do on GET /events; an unsupported value is a 400, never
silently ignored.

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
enum

Only futures that currently have a priced, tenant-visible quote from this venue (for example kalshi or polymarket). Same venue set as GET /v1/events?aggregator=. One value only: a comma-separated list returns 400; send one request per venue.

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

Updated 6 months ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 6 months ago

Did this page help you?