Skip to main content
GET
Futures Filtered

Authorizations

apiKey
string
query
required

Your API key (query-based auth for v5).

Query Parameters

futureIds
string | null

Comma-separated internal future IDs.

sportId
integer | null

Single sport ID.

tournamentId
integer | null

Single tournament ID.

startTimeFrom
integer | null

Earliest startTime (epoch seconds, inclusive).

startTimeTo
integer | null

Latest startTime (epoch seconds, inclusive).

bookmakers
string | null

If provided, includes bookmakers meta per future.

Response

Returns FutureMeta[]

futureId
string
required

Future identifier: {providerSlug}{sportId}{tournamentId}{seasonId}{marketId} — see Core Concepts → ID structure.

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

List of participants (teams/players) competing in this futures market.

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