Is there a free NHL play-by-play API?

Yes. A free key (no card) includes every endpoint and league: 1,000 calls in the first 30 days, then 125 a month at 1 request per second. Paid plans start at $29/month for 10,000 calls and add webhooks and WebSocket.

Can I get NHL plays pushed live?

On paid plans, each new play is also pushed to you: webhooks send event.play and the WebSocket stream sends event_play, so you don't have to poll the plays endpoint during a game.

Is there an NHL box score endpoint?

Not with player stats: when we checked, NHL box scores came back empty, so use play-by-play and the event detail for NHL games.

NHL play-by-play API

Every NHL play in order, live or final: the play text, type, clock, period and score after the play.

Data is aggregated from public sources and is typically 20-30 seconds behind live play (about 1 second after our source). There is no SLA.

AvailableReturned NHL data when checked.

Get a free API key See plans

Endpoint

GET/api/v1/sports/hockey/leagues/nhl/events/{eventId}/plays

Live NHL example

Request

curl -H "Authorization: Bearer $RSA_API_KEY" \
  "https://www.realtimesportsapi.com/api/v1/sports/hockey/leagues/nhl/events/401892659/plays?limit=3"

Response captured from live data at 2026-11-07 14:07 UTC (refreshed every few minutes). Long arrays are trimmed; meta.rateLimit values are illustrative for a Free key. Plays from Columbus Blue Jackets at Buffalo Sabres.

Response

{
  "success": true,
  "data": [
    {
      "id": "401892659000000520",
      "sequenceNumber": "2",
      "text": "Start of 1st Period",
      "shortText": "Start of 1st Period",
      "alternativeText": "Start of 1st Period",
      "type": {
        "id": "518",
        "text": "Period Start",
        "abbreviation": "period-start"
      },
      "period": 1,
      "clock": {
        "value": 0,
        "displayValue": "0:00"
      },
      "wallClock": "2026-11-07T00:13:22Z",
      "homeScore": 0,
      "awayScore": 0,
      "scoringPlay": false,
      "scoreValue": 0,
      "situation": null,
      "endSituation": null,
      "athletes": [],
      "priority": false,
      "modified": "2026-11-07T06:24Z"
    },
    {
      "id": "401892659000000510",
      "sequenceNumber": "3",
      "text": "Charlie Coyle faceoff won against Tyson Kozak",
      "shortText": "Charlie Coyle faceoff won against Tyson Kozak",
      "alternativeText": "Charlie Coyle faceoff won against Tyson Kozak",
      "type": {
        "id": "502",
        "text": "Face Off",
        "abbreviation": "faceoff"
      },
      "period": 1,
      "clock": {
        "value": 0,
        "displayValue": "0:00"
      },
      "wallClock": "2026-11-07T00:13:22Z",
      "homeScore": 0,
      "awayScore": 0,
      "scoringPlay": false,
      "scoreValue": 0,
      "situation": null,
      "endSituation": null,
      "athletes": [
        {
          "id": "2555315",
          "name": "Charlie Coyle",
          "displayName": "Charlie Coyle",
          "shortName": "C. Coyle",
          "position": "C",
          "team": {
            "id": "29"
          },
          "role": "face-off-winner",
          "type": "face-off-winner",
          "order": 1
        },
        {
          "id": "4895527",
          "name": "Tyson Kozak",
          "displayName": "Tyson Kozak",
          "shortName": "T. Kozak",
          "position": "C",
          "team": {
            "id": "2"
          },
          "order": 2
        }
      ],
      "priority": false,
      "modified": "2026-11-07T06:24Z"
    },
    {
      "id": "401892659000000080",
      "sequenceNumber": "4",
      "text": "Puck in Crowd",
      "shortText": "Puck in Crowd",
      "alternativeText": "Puck in Crowd",
      "type": {
        "id": "516",
        "text": "Stoppage",
        "abbreviation": "stoppage"
      },
      "period": 1,
      "clock": {
        "value": 5,
        "displayValue": "0:05"
      },
      "wallClock": "2026-11-07T00:13:27Z",
      "homeScore": 0,
      "awayScore": 0,
      "scoringPlay": false,
      "scoreValue": 0,
      "situation": null,
      "endSituation": null,
      "athletes": [],
      "priority": false,
      "modified": "2026-11-07T06:24Z"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "pageSize": 3,
      "total": 310,
      "totalPages": 104,
      "hasNextPage": true,
      "hasPreviousPage": false
    },
    "rateLimit": {
      "limit": 125,
      "remaining": 124,
      "reset": 1796083200000
    }
  }
}

Code samples

curl

curl -H "Authorization: Bearer $RSA_API_KEY" \
  "https://www.realtimesportsapi.com/api/v1/sports/hockey/leagues/nhl/events/401892659/plays?limit=3"

JavaScript (fetch)

const res = await fetch("https://www.realtimesportsapi.com/api/v1/sports/hockey/leagues/nhl/events/401892659/plays?limit=3", {
  headers: { Authorization: `Bearer ${process.env.RSA_API_KEY}` }
});
const { success, data, meta } = await res.json();
console.log(data, meta.rateLimit);

Python (requests)

import os, requests

res = requests.get(
    "https://www.realtimesportsapi.com/api/v1/sports/hockey/leagues/nhl/events/401892659/plays?limit=3",
    headers={"Authorization": f"Bearer {os.environ['RSA_API_KEY']}"},
    timeout=10,
)
body = res.json()
print(body["data"])

MCP prompt (Claude, Cursor, ChatGPT)

Using the Realtime Sports MCP server (https://www.realtimesportsapi.com/api/mcp), call get_plays with sport "hockey" and league "nhl" and pick a finished game from get_events and summarize its scoring plays for NHL.

Connect the hosted MCP server first: setup guide. Each tool call counts as one API call.

Each request above is 1 call. Free covers 125 calls a month after a 1,000-call first month, at 1 request/second. Starter is $29/month for 10,000 calls (about 333 a day) plus webhooks and WebSocket, so you stop polling for changes; 7-day free trial. Compare plans

Fields

Field	Type	Notes
id	string
sequenceNumber	string
text	string
shortText	string
alternativeText	string
type	object
period	integer
clock	object
wallClock	string
homeScore	integer
awayScore	integer
scoringPlay	boolean
scoreValue	integer
scoringType	string
situation	object
endSituation	object
yardsGained	integer
teamId	string
athletes	PlayAthlete[]
priority	boolean
modified	string

Rate limits and pricing

Plan	Price	Calls	Rate	WebSocket	Webhooks
Free	$0	125/mo (1,000 first 30 days)	1/s	500 msgs/mo	No
Starter	$29/mo ($290/yr)	10,000/mo	5/s	Shares monthly pool	Shares monthly pool
Growth	$49/mo ($490/yr)	25,000/mo	10/s	Shares monthly pool	Shares monthly pool
Pro	$99/mo ($990/yr)	50,000/mo	20/s	100,000 msgs/mo	25,000/mo
Business	$179/mo ($1,790/yr)	150,000/mo	40/s	300,000 msgs/mo	75,000/mo
Scale	$299/mo ($2,990/yr)	500,000/mo	100/s	500,000 msgs/mo	100,000/mo

Every successful REST call counts as one call. Over the limit you get HTTP 429 with a Retry-After header. No SLA. Full pricing.

FAQ

Is there a free NHL play-by-play API?: Yes. A free key (no card) includes every endpoint and league: 1,000 calls in the first 30 days, then 125 a month at 1 request per second. Paid plans start at $29/month for 10,000 calls and add webhooks and WebSocket.
Can I get NHL plays pushed live?: On paid plans, each new play is also pushed to you: webhooks send event.play and the WebSocket stream sends event_play, so you don't have to poll the plays endpoint during a game.
Is there an NHL box score endpoint?: Not with player stats: when we checked, NHL box scores came back empty, so use play-by-play and the event detail for NHL games.