ODoddspapi
futures

Futures Live

Changed on

List live futures.

Lookup mode: optional sportId / tournamentId filters.

get/futures/live

Request

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

Query parameters

sportIdinteger nullable

Filter by sportId.

tournamentIdinteger nullable

Filter by tournamentId.

bookmakersstring nullable

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

Response

Returns FutureMeta[] (live only)

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