ODoddspapi
futures

Futures Filtered

Changed on

List futures.

Lookup mode: futureIds OR sportId OR tournamentId (at least one).

get/futures

Request

  • Base URL
    https://v5.oddspapi.io/en
  • URL
    https://v5.oddspapi.io/en/futures
  • Auth
    • API key in query parameter apiKey
    • or API key in header X-API-Key

Query parameters

futureIdsstring nullable

Comma-separated internal future IDs.

sportIdinteger nullable

Single sport ID.

tournamentIdinteger nullable

Single tournament ID.

startTimeFrominteger nullable

Earliest startTime (epoch seconds, inclusive).

startTimeTointeger nullable

Latest startTime (epoch seconds, inclusive).

bookmakersstring nullable

If provided, includes bookmakers meta per future AND filters by mapping. Note: no future currently carries a bookmaker mapping, so passing any value — including * or empty — returns an empty result set.

Response

Returns FutureMeta[]

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

reissuedFutureIdstring nullable 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.

previousFutureIdstring nullable 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.

startTimeinteger required

Epoch seconds (UTC).

endTimeinteger required

Epoch seconds (UTC).

externalProvidersExternalProviders required
bookmakersobject required

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

Changes

  • 9ca3a6a3c1e8Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status