Skip to main content
GET
Futures Live

Authorizations

apiKey
string
query
required

Your API key as the apiKey query parameter.

Query Parameters

sportId
integer | null

Filter by sportId.

tournamentId
integer | null

Filter by tournamentId.

bookmakers
string | null

Comma/space-separated bookmaker slugs (default: all).

Response

Returns FutureMeta[] (live only)

futureId
string
required

Future identifier: {prefix}{sportId}{seasonId}{futureMarketId} — see Core Concepts → Future IDs. Tournament is a field on the future, not a segment of this ID.

reissuedFutureId
string | null
required

The future that replaced this one, when a cancelled future has been re-listed under a new id. null is the normal value: it is only ever populated on a cancelled future (status.statusId 3) whose replacement already exists in the feed, so permanent cancellations stay null, and a future can go from null to an id after you first saw it cancelled. One hop: if the replacement was itself cancelled, follow its own reissuedFutureId.

previousFutureId
string | null
required

The inverse of reissuedFutureId: the cancelled future this one replaced. Unlike the forward pointer this sits on a normal open future, so a future carries its own history even if you never saw the cancelled one. null is the normal value. One hop and one predecessor at most — follow it repeatedly to walk back to the start of a chain. Cleared again if a cancellation is reverted.

status
object
required

Lifecycle status of the future.

sport
object
required

Sport (or prediction-market topic) reference.

tournament
object
required

Tournament reference.

season
object
required

Season reference.

startTime
integer
required

Epoch seconds (UTC).

endTime
integer
required

Epoch seconds (UTC).

market
object
required

Future market reference (e.g. Winner).

participants
object[]
required

Participants attached to this future. Not currently populated in production — every future returns [] (0 of 2,018 sampled across 40 sports carried any participant), so resolve names via /participants or the tournament/season metadata instead.

externalProviders
object
required

Native identifiers of this future at external providers (polymarket, kalshi, …).

bookmakers
object
required

Per-bookmaker metadata for this future. Contains only bookmakers that currently offer valid realtime odds (empty object when none do).