Skip to content

Guides

How do I get first half NFL odds history in Python?

Each sportsbook's opening and closing 1st half point spread for a game, from the 2023 season, 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 the 1st half winner and total, 1st quarter markets, the 2nd half total and each quarter's total.

import requests
import pandas as pd

API_KEY = "YOUR_API_KEY"

resp = requests.post(
    "https://mcp.endzoneapi.com/v1/get_market_odds",
    headers={"x-api-key": API_KEY},
    json={
        "game_id": "2025_05_DAL_NYJ",
        "market": "spreads_h1",
    },
    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 endzoneapi

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": "2025_05_DAL_NYJ",
  "market": "spreads_h1",
  "label": "1st half point spread",
  "scheduled_start": "2025-10-05T17:00:00.000Z",
  "books": [
    {
      "bookmaker": "betmgm",
      "opening": [
        {
          "outcome": "New York Jets",
          "point": -0.5,
          "price": 100
        },
        {
          "outcome": "Dallas Cowboys",
          "point": 0.5,
          "price": -120
        }
      ],
      "opening_captured_at": "2025-10-05T16:30:38.000Z",
      "closing": [
        {
          "outcome": "New York Jets",
          "point": -0.5,
          "price": 100
        },
        {
          "outcome": "Dallas Cowboys",
          "point": 0.5,
          "price": -120
        }
      ],
      "closing_captured_at": "2025-10-05T16:30:38.000Z",
      "minutes_before_start": 29.4
    },
    "...4 more"
  ],
  "count": 6
}

What to do next

  • get_plays (10 credits). Every play with its quarter, to settle a half.
  • get_alt_lines (10 credits). The ladder of alternate full-game spreads and totals.

More guides

The same guide for other sports

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

Start with 500 free credits every month

No card. REST or MCP.