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

# List Odds

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

Bulk odds for a sport. Filter by market keys (comma-separated).

## Path parameters

- `sport_key` string, required

## Query parameters

- `markets` string
- `bookmakers` string, nullable — Comma-separated bookmaker keys (e.g. 'draftkings,fanduel'). Omitted = all books. Matches the-odds-api's `bookmakers` param.
- `period` string, nullable — Game-period filter. Omitted = full-game markets only (backwards-compatible default). Pass a comma-separated list of canonical codes (e.g. 'q1,q2' or 'h1') to filter to specific periods. Pass 'all' to include every period alongside full-game.
- `includeLinks` boolean — When true, each bookmaker block carries a `link` — that book's public event-page URL (plain navigation, no affiliate tagging). Only books with a verified URL template emit links (Bovada, DraftKings, FanDuel, BetMGM, Kalshi, Polymarket, Smarkets); others return null. Matches the-odds-api's `includeLinks` param.

## Response `200`

Successful Response

- EventOddsOut[]
  - `id` string, required
  - `sport_key` string, required
  - `home_team` string, required
  - `away_team` string, required
  - `commence_time` string, date-time, required
  - `live` boolean
  - `last_update` string, date-time, nullable
  - `bookmakers` BookmakerOut[], required
    - `key` string, required
    - `title` string, required
    - `last_update` string, date-time, nullable
    - `link` string, nullable
    - `markets` MarketOut[], required
      - `key` string, required
      - `last_update` string, date-time, required
      - `period` string, nullable
      - `outcomes` OutcomeOut[], required
        - `name` string, required
        - `description` string, required
        - `price` integer, nullable, required
        - `point` number, nullable, required
        - `book_updated_at` string, date-time, nullable
        - `book_version` integer, nullable
        - `payout_multiplier` number, nullable
        - `dfs_odds_type` string, nullable
        - `last_change_at` string, date-time, nullable
        - `line_gap` number, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/prop-line/apis/player-props-api.md) · [All operations](https://skmtc.net/prop-line/apis/player-props-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prop-line/player-props-api/revisions/36072dd255f2/schema)