Skip to content

Guides

How do I get first period NHL odds history in Python?

Each sportsbook's opening and closing 1st period total for a game, from May 2023, for the larger books.

Code verified November 3, 2026. One call to get_market_odds, 10 credits.

The call

game_id comes from get_games. Also 2nd and 3rd period totals, the 1st period result and puck line, and the regulation result.

import requests
import pandas as pd

API_KEY = "YOUR_API_KEY"

resp = requests.post(
    "https://mcp.puckapi.com/v1/get_market_odds",
    headers={"x-api-key": API_KEY},
    json={
        "game_id": "2023020781",
        "market": "totals_p1",
    },
    timeout=60,
)
resp.raise_for_status()
data = resp.json()["data"]

books = pd.DataFrame([
    {"book": b["bookmaker"], **{f'{o["outcome"]} {o["point"] if o["point"] is not None else ""}'.strip(): o["price"] for o in b["closing"]}}
    for b in data["books"]
])
print(data["label"])
print(books)

Replace YOUR_API_KEY with a key from your dashboard. Python needs requests and pandas (pip install requests pandas). JavaScript runs on Node 18 or newer, or in the browser.

Or use the official client: pip install puckapi

What comes back

The data object of the response, trimmed to the first rows. Every field is real output from the run above.

{
  "game_id": "2023020781",
  "market": "totals_p1",
  "label": "1st period total goals",
  "scheduled_start": "2024-02-06T00:00:00.000Z",
  "books": [
    {
      "bookmaker": "betmgm",
      "opening": [
        {
          "outcome": "Over",
          "point": 1.5,
          "price": -155
        },
        {
          "outcome": "Under",
          "point": 1.5,
          "price": 110
        }
      ],
      "opening_captured_at": "2024-02-05T23:25:39.000Z",
      "closing": [
        {
          "outcome": "Over",
          "point": 1.5,
          "price": -155
        },
        {
          "outcome": "Under",
          "point": 1.5,
          "price": 110
        }
      ],
      "closing_captured_at": "2024-02-05T23:25:39.000Z",
      "minutes_before_start": 34.4
    },
    "...5 more"
  ],
  "count": 7
}

What to do next

  • get_plays (10 credits). Every event of the game, to settle a period total.
  • get_odds (10 credits). The full-game moneyline, puck line and total.

More guides

The same guide for other sports

The latest lines from every book are on the odds board. Rather ask Claude? 28 free Claude skills call these endpoints for you.

Start with 500 free credits every month

No card. REST or MCP.