---
title: "List Futures"
method: GET
path: "/v1/sports/{sport_key}/futures"
tags: ["Events & Odds"]
---

# List Futures

`GET /v1/sports/{sport_key}/futures`

## Request

- Base URL: `https://api.prop-line.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.prop-line.com/v1/sports/{sport_key}/futures`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `apiKey`

List futures markets for a sport — championship winner, MVP,
division winner, etc. One row per (futures event, book, market) with
every team or player priced. Free tier; pulled from each book's
futures feed (Bovada today). Order is by event commence_time
(typically season-end) ascending.

Optional `?bookmakers=` (comma-separated book keys) narrows the
per-book market rows to those books — same the-odds-api-compatible
contract as every /odds endpoint: omitted = all books, unknown keys
match nothing. A futures event with no market left after filtering is
dropped so consumers never get an empty `markets: []` row.

## Path parameters

- `sport_key` string, required

## Query parameters

- `bookmakers` string, nullable: Comma-separated bookmaker keys (e.g. 'draftkings,fanduel'). Omitted = all books. Matches the-odds-api's `bookmakers` param.

## Response `200`

Successful Response

- FuturesEventOut[]
  - `id` string, required
  - `sport_key` string, required
  - `title` string, required
  - `commence_time` string, date-time, required
  - `markets` FuturesMarketOut[], required
    - `key` string, required
    - `description` string, required
    - `bookmaker` string, required
    - `bookmaker_title` string, required
    - `last_update` string, date-time, required
    - `book_updated_at` string, date-time, nullable
    - `outcomes` FuturesOutcomeOut[], required
      - `name` string, required
      - `description` string
      - `price` integer, nullable, required
      - `price_decimal` number, nullable, required
      - `point` number, nullable
      - `resolution` string, nullable
      - `actual_value` number, nullable
      - `settled_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

## Changes

> 89 revisions in range; 4 not diffed.

- **2026-08-28** `001deb53edca`: 1 info
  - added the new optional `query` request parameter `bookmakers`

[Operation history](https://skmtc.dev/prop-line/apis/player-props-api/changes/v1/sports/:sport_key/futures/get.md)

---

[API](https://skmtc.dev/prop-line/apis/player-props-api.md) - [All operations](https://skmtc.dev/prop-line/apis/player-props-api/llms.txt) - [OpenAPI document](https://skmtc.dev/prop-line/apis/player-props-api/revisions/d3654129ada4?raw)