Skip to main content
GET
/
futures
Futures Filtered
curl --request GET \
  --url 'https://v5.oddspapi.io/en/futures?apiKey='
[
  {
    "futureId": "pm6980037088158379224",
    "status": {
      "live": true,
      "statusId": 1,
      "statusName": "Live"
    },
    "sport": {
      "sportId": 69,
      "sportName": "Politics"
    },
    "tournament": {
      "tournamentId": 800370,
      "tournamentName": "2025 Predictions",
      "categoryName": "Politics"
    },
    "season": {
      "seasonId": 8815837922,
      "seasonName": "Macron out by...?"
    },
    "startTime": 1735932904,
    "endTime": 1782820800,
    "market": {
      "marketId": 4,
      "marketName": null,
      "marketType": null
    },
    "participants": [],
    "externalProviders": {
      "betradarId": null,
      "flashscoreId": null,
      "opticoddsId": null,
      "polymarketId": "16263",
      "kalshiId": null,
      "sofascoreId": null
    },
    "bookmakers": {}
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.oddspapi.io/llms.txt

Use this file to discover all available pages before exploring further.

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
​
startTimeTo
integer | null
​
bookmakers
string | null

If provided, includes bookmakers meta per future.

Response

Returns FutureMeta[]

​
futureId
string
required
​
status
object
required
​
sport
object
required
​
tournament
object
required
​
season
object
required
​
startTime
integer
required
​
endTime
integer
required
​
market
object
required
​
participants
object[]
required

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

​
externalProviders
object
required
​
bookmakers
object
required