---
title: "Predictions"
method: POST
path: "/v1/get_predictions"
tags: ["Stats + aggregation"]
---

# Predictions

`POST /v1/get_predictions`

## Request

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

Use for the model's win probability for each NHL game on the current slate: home and away win probability, the A/B/C confidence grade, start time, plus the model version and when the slate was generated. Takes no arguments (current slate only). Probabilities are the model's own; no odds, prices or goalie and injury notes are included. The accuracy note states the backtest figure and that it is not a live record. An empty slate costs nothing, and a note says why (not generated yet, or no games today); so does a failed call. Costs 5 credits.

## Request body

- object

## Response `200`

The result, wrapped in data.

- object
  - `data` object, required
    - `generatedAt` string, required
    - `modelVersion` string, required
    - `accuracyNote` string, required
    - `games` object[], required
      - `gameId` string, required
      - `gameDate` string, required
      - `startTimeUtc` string, required
      - `homeTeam` string, required
      - `awayTeam` string, required
      - `homeWinProb` number, required
      - `awayWinProb` number, required
      - `grade` string, required
    - `count` number, required
    - `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)