---
title: "Future Odds"
method: GET
path: "/futures/odds"
tags: ["futures/odds"]
---

# Future Odds

`GET /futures/odds`

Get latest odds for a future.

Lookup mode: required `futureId` + optional filters (`bookmakers`, `since`, `mainLines`, `includeFuture`).

## Query parameters

- `futureId` string, required
- `bookmakers` string, nullable
- `since` integer, nullable
- `mainLines` boolean
- `includeFuture` boolean

## Response `200`

Returns FutureOddsResponse

- FutureOddsResponse
  - `futureId` string, required
  - `bookmakers` object, required
  - `futureMeta` FutureMeta
    - `futureId` string, required
    - `status` Status, required
      - `live` boolean, required
      - `statusId` integer, required
      - `statusName` string, required
    - `sport` SportRef, required
      - `sportId` integer, required
      - `sportName` string, required
    - `tournament` TournamentRef, required
      - `tournamentId` integer, required
      - `tournamentName` string, required
      - `categoryName` string, nullable
    - `season` SeasonRef, required
      - `seasonId` integer, nullable
      - `seasonName` string, nullable
      - `seasonRound` integer, nullable
    - `startTime` integer, required
    - `endTime` integer, required
    - `market` FutureMarketRef, required
      - `marketId` integer, nullable
      - `marketName` string, nullable
      - `marketType` string, nullable
    - `participants` object[], required — List of participants (teams/players) competing in this futures market.
      - `participantId` integer, required
      - `participantName` string, nullable
    - `externalProviders` ExternalProviders, required
    - `bookmakers` object, required

## Other responses

- `400` — API error
- `401` — API error
- `403` — API error
- `422` — Validation Error (framework-level)
- `429` — API error

---

[API](https://skmtc.net/oddspapi/apis/odds-api-v5.md) · [All operations](https://skmtc.net/oddspapi/apis/odds-api-v5/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oddspapi/odds-api-v5/revisions/5fe687d7c592/schema)