Skip to content

Guides

How often does an NHL star go over his points line?

One row per game with a player's points line, the price, his points and whether he went over. Connor McDavid's line was 1.5 all season and he went over in 43 of 83.

Code verified October 19, 2026. One call to get_prop_history, 10 credits.

The call

player_id comes from search_players. Other markets: goals, assists, shots on goal, blocked shots, goalie saves and anytime goal scorer.

import requests
import pandas as pd

API_KEY = "YOUR_API_KEY"

resp = requests.post(
    "https://mcp.puckapi.com/v1/get_prop_history",
    headers={"x-api-key": API_KEY},
    json={
        "player_id": 8478402,
        "market": "player_points",
        "from_date": "2025-10-01",
        "to_date": "2026-04-20",
        "limit": 100,
    },
    timeout=60,
)
resp.raise_for_status()
data = resp.json()["data"]

games = pd.DataFrame(data["games"])
s = data["summary"]
print(data["player_name"], data["stat"], "|", s["overs"], "overs,", s["unders"], "unders, over rate", s["over_rate"])
print("average line", s["avg_line"], "average actual", s["avg_actual"])
print(games[["game_date", "open_line", "line", "actual", "result"]].tail(6).to_string(index=False))
# Over rate by the price on the over: does a heavier favourite clear more often?
games["price"] = pd.cut(games["over_odds"], [-1000, -130, -110, 1000], labels=["-130 or shorter", "-129 to -110", "longer"])
print(games.groupby("price", observed=True)["result"].value_counts().unstack(fill_value=0))

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.

{
  "player_id": 8478402,
  "player_name": "Connor McDavid",
  "market": "player_points",
  "stat": "points",
  "bookmaker": null,
  "games": [
    {
      "game_id": "2025020006",
      "game_date": "2025-10-08",
      "line": 1.5,
      "open_line": 1.5,
      "over_odds": -127,
      "under_odds": -105,
      "books": 6,
      "actual": 2,
      "result": "over",
      "margin": 0.5
    },
    {
      "game_id": "2025020035",
      "game_date": "2025-10-11",
      "line": 1.5,
      "open_line": 1.5,
      "over_odds": -133,
      "under_odds": 100,
      "books": 6,
      "actual": 1,
      "result": "under",
      "margin": -0.5
    },
    {
      "game_id": "2025020051",
      "game_date": "2025-10-14",
      "line": 1.5,
      "open_line": 1.5,
      "over_odds": -130,
      "under_odds": -105,
      "books": 6,
      "actual": 1,
      "result": "under",
      "margin": -0.5
    },
    {
      "game_id": "2025020065",
      "game_date": "2025-10-16",
      "line": 1.5,
      "open_line": 1.5,
      "over_odds": -123,
      "under_odds": -110,
      "books": 6,
      "actual": 1,
      "result": "under",
      "margin": -0.5
    }
  ],
  "count": 83,
  "summary": {
    "games": 83,
    "graded": 83,
    "overs": 43,
    "unders": 40,
    "pushes": 0,
    "over_rate": 0.518,
    "avg_line": 1.5,
    "avg_actual": 1.7
  },
  "truncated": false,
  "next_from_date": null
}

The example player is Connor McDavid. The record against the line, market by market, is on the Connor McDavid prop history page.

What to do next

More guides

The same guide for other sports

The latest lines from every book are on the odds board. Today's props, with the best price on each side, are on the player props 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.