---
title: "Odds"
method: POST
path: "/v1/get_odds"
tags: ["Multi-table"]
---

# Odds

`POST /v1/get_odds`

## Request

- Base URL: `https://mcp.puckapi.com`
- URL: `https://mcp.puckapi.com/v1/get_odds`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Use when checking betting lines. Pass game_id for one game (10 credits): moneyline, puck line and total by bookmaker, opening and closing. Or pass season (optionally with team) for a whole season of closing lines in one call, with final scores, at 10 credits per game returned (a full season is ~13,700 credits, a team-season ~820), 100 games a page by default (up to 500). Each book's line is an array in the order given by columns. Set estimate_only to get the price without being charged. Every game from 2019-20 on (and part of the 2019 playoffs): about 16 to 18 books a game from 2020-21 to 2023-24, about 6 in 2019-20, 8 in 2024-25 and 2025-26 (60+ on about 300 games in 2025-26), with all_books; a season answer defaults to the four main books. A season those four do not carry (2019-20) returns every book it has. Each line carries a source field (one value for opening and closing lines from August 2020, another for final per-book lines); a season answer lists each game's sources. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

## Request body

- object
  - `game_id` string: NHL game ID (e.g. 2025020887). Omit and pass season for a whole season.
  - `season` string: Season for a whole season of lines, e.g. 2025-26 or 20252026. Used when game_id is not set.
  - `team` string: With season: only this team's games (abbreviation, e.g. BUF).
  - `bookmaker` string: Filter by bookmaker key (e.g. draftkings, fanduel, betmgm). Lowercase.
  - `snapshot_type` 'opening' | 'closing': opening (game-day morning; for a game not yet played, the latest morning line) or closing (final pre-game). Single game: default every snapshot held, including first (each book's first posted line, from October 2026). Season: default closing.
  - `all_books` boolean: With season: every book held (16 to 18 a game from 2020-21 to 2023-24, 8 in 2024-25, more than 60 on about 300 games in 2025-26) instead of DraftKings, FanDuel, BetMGM and ESPN BET.
  - `limit` integer: With season: games per page (default 100, max 500).
  - `offset` integer: With season: page offset; use next_offset from the previous page.
  - `estimate_only` boolean: Return what this call would cost, without charging or running it.

## Response `200`

The result, wrapped in data.

- object
  - `data` object, required
    - `game_id` string
    - `home_team` string
    - `away_team` string
    - `game_date` string, nullable
    - `odds` object[]
      - `bookmaker` string, required
      - `snapshotType` string, nullable, required
      - `source` string, nullable, required
      - `mlHome` number, nullable, required
      - `mlAway` number, nullable, required
      - `mlHomeProb` number, nullable, required
      - `mlAwayProb` number, nullable, required
      - `spreadHome` number, nullable, required
      - `spreadHomeOdds` number, nullable, required
      - `spreadAway` number, nullable, required
      - `spreadAwayOdds` number, nullable, required
      - `total` number, nullable, required
      - `totalOverOdds` number, nullable, required
      - `totalUnderOdds` number, nullable, required
      - `capturedAt` string, nullable, required
    - `bookmaker_count` number
    - `season` string
    - `games` object[]
    - `count` number
    - `total_games` number
    - `next_offset` number, nullable
    - `credits_per_game` number
    - `snapshot_type` string
    - `columns` string[]
    - `estimate_only` boolean
    - `tool` string
    - `credits` number
    - `note` string

## Other responses

- `400`: Invalid arguments.
- `401`: Missing or invalid API key.
- `402`: Not enough credits.
- `429`: Rate limited.

---

[API](https://skmtc.dev/puckapi/apis/puckapi-api.md) · [All operations](https://skmtc.dev/puckapi/apis/puckapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/puckapi/apis/puckapi-api/revisions/99b3e5171ab4?raw)