Skip to content

Guides

How often does an NHL player score when he is priced to?

One row per game with a player's anytime goal price, his goals and whether he scored, to set the odds beside what happened. Auston Matthews scored in 23 of 60.

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

The call

player_id comes from search_players. Anytime goal scorer has no line: over means he scored, and the price is the yes side.

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": 8479318,
        "market": "player_goal_scorer_anytime",
        "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"], "anytime goal |", s["overs"], "games with a goal of", s["graded"], "(rate", s["over_rate"], ")")
# The price is the yes side: convert it to the chance the books implied, then compare with what happened.
def implied(odds):
    return 100 / (odds + 100) if odds > 0 else -odds / (-odds + 100)
games["implied"] = games["over_odds"].dropna().apply(implied)
print("books implied", round(games["implied"].mean(), 3), "on average; actual rate", s["over_rate"])
print(games[["game_date", "over_odds", "actual", "result"]].tail(6).to_string(index=False))

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": 8479318,
  "player_name": "Auston Matthews",
  "market": "player_goal_scorer_anytime",
  "stat": "goals",
  "bookmaker": null,
  "games": [
    {
      "game_id": "2025020004",
      "game_date": "2025-10-08",
      "line": null,
      "open_line": null,
      "over_odds": 105,
      "under_odds": null,
      "books": 4,
      "actual": 1,
      "result": "over",
      "margin": null
    },
    {
      "game_id": "2025020025",
      "game_date": "2025-10-11",
      "line": null,
      "open_line": null,
      "over_odds": 110,
      "under_odds": -136,
      "books": 4,
      "actual": 0,
      "result": "under",
      "margin": null
    },
    {
      "game_id": "2025020043",
      "game_date": "2025-10-13",
      "line": null,
      "open_line": null,
      "over_odds": 120,
      "under_odds": -179,
      "books": 5,
      "actual": 0,
      "result": "under",
      "margin": null
    },
    {
      "game_id": "2025020049",
      "game_date": "2025-10-14",
      "line": null,
      "open_line": null,
      "over_odds": 110,
      "under_odds": -138,
      "books": 5,
      "actual": 2,
      "result": "over",
      "margin": null
    }
  ],
  "count": 61,
  "summary": {
    "games": 61,
    "graded": 60,
    "overs": 23,
    "unders": 37,
    "pushes": 0,
    "over_rate": 0.383,
    "avg_line": null,
    "avg_actual": 0.5
  },
  "truncated": false,
  "next_from_date": null,
  "note": "1 of 61 games have no result yet (not played, or no box score or play-by-play of ours for the player)."
}

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

What to do next

  • get_player_props (10 credits). Every sportsbook's anytime price for tonight's game.
  • get_shot_map (10 credits). Where the player shoots from, with expected goals.

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.