NHL API
Realtime Sports API serves NHL games through the same REST endpoints and JSON schema as every other league, using sport=hockey and league=nhl. You get the current scoreboard, live scores, game detail, play-by-play, teams, rosters and news, plus current odds and line history from a single source book and the injury report. Not currently available or not verified for this league: box scores. 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.
- Slugs
- sport=hockey
league=nhl - Teams
- 32
- Season (from data)
- 2026-27 Regular Season
- In the scoreboard now
- 14 games, 1 live
Upcoming and live NHL games
| Date | Away | Home | Time / Result | TV | Venue |
|---|---|---|---|---|---|
| Sat, Nov 21 | Edmonton Oilers | atCarolina Hurricanes | 4 - 5 End of 2nd Period | TV: NHL Net, CARNHL | Lenovo Center · Raleigh, NC |
| Sat, Nov 21 | Chicago Blackhawks | atCalgary Flames | 3:30 PM ET | TV: ESPN+, CHSN | Scotiabank Saddledome · Calgary, AB |
| Sat, Nov 21 | Buffalo Sabres | atFlorida Panthers | 6:00 PM ET | TV: ESPN+, MSGB, Scripps Sports | Amerant Bank Arena · Sunrise, FL |
| Sat, Nov 21 | Pittsburgh Penguins | atNashville Predators | 6:00 PM ET | TV: ESPN+, Scripps Sports | Bridgestone Arena · Nashville, TN |
| Sat, Nov 21 | Washington Capitals | atBoston Bruins | 7:00 PM ET | TV: ESPN+, MNMT, NESN | TD Garden · Boston, MA |
| Sat, Nov 21 | Columbus Blue Jackets | atToronto Maple Leafs | 7:00 PM ET | TV: ESPN+, CBJNHL | Scotiabank Arena · Toronto, ON |
| Sat, Nov 21 | Philadelphia Flyers | atMontreal Canadiens | 7:00 PM ET | TV: NHL Net, NBC Sports Phil | Bell Centre · Montreal, QC |
| Sat, Nov 21 | Los Angeles Kings | atOttawa Senators | 7:00 PM ET | TV: ESPN+, ABTV | Canadian Tire Centre · Ottawa, ON |
From the /events endpoint for this league, refreshed every few minutes. Times are US Eastern. Full NHL schedule · NHL team APIs · Free NHL scoreboard widget
Live example
Request
curl -H "Authorization: Bearer $RSA_API_KEY" \
"https://www.realtimesportsapi.com/api/v1/sports/hockey/leagues/nhl/events?limit=1"Response captured from live data at 2026-11-21 20:00 UTC (refreshed every few minutes). Long arrays are trimmed; meta.rateLimit values are illustrative for a Free key.
Response
{
"success": true,
"data": [
{
"id": "401892754",
"uid": "s:70~l:90~e:401892754",
"name": "Edmonton Oilers at Carolina Hurricanes",
"shortName": "EDM @ CAR",
"date": "2026-11-21T18:00Z",
"status": {
"state": "in",
"completed": false,
"period": 2,
"clock": "0:00",
"detail": "End of 2nd Period",
"halftime": true,
"firstHalfEnded": true
},
"homeTeam": {
"id": "7",
"name": "Carolina Hurricanes",
"abbreviation": "CAR",
"logo": "https://realtimesportsapi.com/api/images/proxy?id=GgcVSgNPTUMITUgaFFQVVVQXBVwOHV5LRQBZD1lbBllDXR0JVl9AUlxGAEwbSkoYVg",
"color": "e30426",
"alternateColor": "000000",
"winner": false,
"score": 5
},
"awayTeam": {
"id": "6",
"name": "Edmonton Oilers",
"abbreviation": "EDM",
"logo": "https://realtimesportsapi.com/api/images/proxy?id=GgcVSgNPTUMITUgaFFQVVVQXBVwOHV5LRQBZD1lbBllDXR0JVl9AUlxGBkkESkoYVg",
"color": "00205b",
"alternateColor": "ff4c00",
"winner": false,
"score": 4
},
"competition": {
"attendance": 18855,
"neutralSite": false,
"conferenceCompetition": false,
"divisionCompetition": false,
"playByPlayAvailable": true,
"highlightsAvailable": true
},
"venue": {
"id": "999",
"name": "Lenovo Center",
"city": "Raleigh",
"state": "NC",
"indoor": true,
"grass": false
},
"notes": [],
"season": {
"year": 2027,
"displayName": "2026-27",
"type": {
"id": "2",
"name": "Regular Season",
"abbreviation": "reg"
},
"week": {}
},
"broadcasts": [
{
"network": "NHL Net",
"type": "TV"
},
{
"network": "CARNHL",
"type": "TV"
}
],
"officials": [
{
"id": "2553139",
"fullName": "David Brisebois",
"displayName": "David Brisebois",
"order": 0,
"position": "Linesman"
},
{
"id": "4063898",
"fullName": "Peter MacDougall",
"displayName": "Peter MacDougall",
"order": 0,
"position": "Referee"
},
{
"id": "4064342",
"fullName": "Furman South",
"displayName": "Furman South",
"order": 0,
"position": "Referee"
},
"... 1 more"
]
}
],
"meta": {
"rateLimit": {
"limit": 125,
"remaining": 124,
"reset": 1796083200000
}
}
}NHL play-by-play example
Request
curl -H "Authorization: Bearer $RSA_API_KEY" \
"https://www.realtimesportsapi.com/api/v1/sports/hockey/leagues/nhl/events/401892754/plays?limit=3"Response captured from live data at 2026-11-21 20:00 UTC (refreshed every few minutes). Long arrays are trimmed; meta.rateLimit values are illustrative for a Free key. Plays from Edmonton Oilers at Carolina Hurricanes.
Response
{
"success": true,
"data": [
{
"id": "401892754000000520",
"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-21T18:16:06Z",
"homeScore": 0,
"awayScore": 0,
"scoringPlay": false,
"scoreValue": 0,
"situation": null,
"endSituation": null,
"athletes": [],
"priority": false,
"modified": "2026-11-21T18:16Z"
},
{
"id": "401892754000000510",
"sequenceNumber": "3",
"text": "Jordan Staal faceoff won against Connor McDavid",
"shortText": "Jordan Staal faceoff won against Connor McDavid",
"alternativeText": "Jordan Staal faceoff won against Connor McDavid",
"type": {
"id": "502",
"text": "Face Off",
"abbreviation": "faceoff"
},
"period": 1,
"clock": {
"value": 0,
"displayValue": "0:00"
},
"wallClock": "2026-11-21T18:16:06Z",
"homeScore": 0,
"awayScore": 0,
"scoringPlay": false,
"scoreValue": 0,
"situation": null,
"endSituation": null,
"athletes": [
{
"id": "3541",
"name": "Jordan Staal",
"displayName": "Jordan Staal",
"shortName": "J. Staal",
"position": "C",
"team": {
"id": "7"
},
"role": "face-off-winner",
"type": "face-off-winner",
"order": 1
},
{
"id": "3895074",
"name": "Connor McDavid",
"displayName": "Connor McDavid",
"shortName": "C. McDavid",
"position": "C",
"team": {
"id": "6"
},
"order": 2
}
],
"priority": false,
"modified": "2026-11-21T18:16Z"
},
{
"id": "401892754000000080",
"sequenceNumber": "4",
"text": "Icing",
"shortText": "Icing",
"alternativeText": "Icing",
"type": {
"id": "516",
"text": "Stoppage",
"abbreviation": "stoppage"
},
"period": 1,
"clock": {
"value": 6,
"displayValue": "0:06"
},
"wallClock": "2026-11-21T18:16:12Z",
"homeScore": 0,
"awayScore": 0,
"scoringPlay": false,
"scoreValue": 0,
"situation": null,
"endSituation": null,
"athletes": [],
"priority": false,
"modified": "2026-11-21T18:16Z"
}
],
"meta": {
"pagination": {
"page": 1,
"pageSize": 3,
"total": 223,
"totalPages": 75,
"hasNextPage": true,
"hasPreviousPage": false
},
"rateLimit": {
"limit": 125,
"remaining": 124,
"reset": 1796083200000
}
}
}Play-by-play API reference · Paid plans can receive each play as it happens over WebSocket or webhooks instead of polling.
Build with the NHL API
- Build NHL goal alerts with a goal hornNode.js · NHL · ntfy
- Add live scores to Home AssistantHome Assistant · YAML · Jinja
- Build an ESP32 live scoreboardESP32 · Arduino · ArduinoJson · SSD1306
- Build a Telegram live scores botNode.js · Telegram Bot API
- Add a live score overlay to your streamOBS · Node.js · HTML
NHL endpoints
Checked against live data on 2026-10-04. Paths are relative to /api/v1/sports/hockey/leagues/nhl.
| Endpoint | Path | NHL | Notes |
|---|---|---|---|
| Live scores | /events/live | Available | |
| Events (scoreboard) | /events | Available | |
| Event detail | /events/{eventId} | Available | |
| Play-by-play | /events/{eventId}/plays | Available | |
| Box score | /events/{eventId}/boxscore | Not available | |
| Odds | /events/{eventId}/odds | Available | |
| Win probability | /events/{eventId}/winprobability | Not available | |
| Teams | /teams | Available | |
| Rosters | /teams/{teamId}/roster | Available | |
| Athletes | /athletes/search | Available | |
| Injuries | /injuries | Available | |
| News | /news | Available | |
| Schedule / weeks | /seasons/{season}/schedule | Available | |
| NCAA tournament | /seasons/{season}/tournament | Not available | |
| Rankings | /rankings | Not available | |
| Webhooks | /webhooks | Available | |
| WebSocket | /websocket/auth | Available |
- Schedules are by date, not week: use /events for the current scoreboard and /seasons/{season}/schedule for a season. Week parameters return SCHEDULE_WEEKS_NOT_SUPPORTED.
Every NHL game in the events, live and schedule endpoints uses the same Event object as other leagues: Event object field reference.
NHL API in Python, JavaScript and curl
curl
curl -H "Authorization: Bearer $RSA_API_KEY" \
"https://www.realtimesportsapi.com/api/v1/sports/hockey/leagues/nhl/events?limit=5"JavaScript (fetch)
const res = await fetch("https://www.realtimesportsapi.com/api/v1/sports/hockey/leagues/nhl/events?limit=5", {
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?limit=5",
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_events with sport "hockey" and league "nhl" and list the games it returns with start times, status and scores 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
Real-time NHL push: WebSocket and webhooks
Instead of polling, paid plans can receive every NHL game start, score change and final as it is detected (typically 20-30 seconds behind live play): a NHL WebSocket feed for live dashboards and apps, or NHL webhooks that POST each event to your server. On the Free plan you can watch the stream and send yourself a sample webhook from the dashboard.
Shipping a product with NHL data?
Polling works on every plan. Production apps usually also want events pushed to them, by webhook or WebSocket, as soon as we detect them (typically 20-30 seconds behind live play). These guides show the setup and the plan each one needs.
- Score alerts for your sports app, without pollingWebhooks into your backend, then FCM/APNs · Starter ($29/mo)
- Live scoreboards and game pages for news and media sitesCached REST on your server; optional WebSocket for live ticks · Starter ($29/mo)
- Player stats and box scores for fantasy platformsREST box scores during games, webhooks for finals and plays · Growth ($49/mo)
- Live scores on the screens in your venueFree widget, or one WebSocket feeding every screen · Starter ($29/mo)
- A play-by-play feed for your analytics stackWebSocket for live plays, REST to backfill and reconcile · Growth ($49/mo)
- Stream live scores to your backend over WebSocketWebSocket (server to server) · Starter ($29/mo)
- Sports data for a startup, from prototype to scaleREST, WebSocket and webhooks on one key · Starter ($29/mo)
NHL API pricing and rate limits
The NHL API is included in every plan, Free included: one key covers all leagues. Free starts with 1,000 calls in your first 30 days (no card); paid plans start at $29/month with a 7-day free trial.
| 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.
29 leagues monitored live: NFL, college football, NBA, men's college basketball, MLB, NHL and 23 soccer competitions.
FAQ
- Is there a free NHL API?
- Yes. The Free plan is $0 with 125 calls per month (1,000 in the first 30 days) at 1 request per second, no card required. The same key works for all 29 leagues.
- How fresh is the NHL data?
- 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. It is not intended for in-play betting that needs sub-second data.
- Which NHL endpoints are available?
- Available: live scores, events (scoreboard), event detail, play-by-play, odds, teams, rosters, athletes, injuries, news, schedule / weeks. Not available or not verified: box score (not available), win probability (not available), ncaa tournament (not available), rankings (not available).
- Does the NHL API include betting odds?
- Yes. Upcoming NHL games returned a spread, moneyline and total when we checked, from a single source book, with line history. It is not a multi-book comparison feed and not suited to sub-second in-play betting.
- Does it include NHL injuries?
- Yes. The injuries endpoint returned current NHL designations grouped by team, and player-availability normalizes them to values like OUT and QUESTIONABLE. Pass team for a complete team report.
- Can I get NHL score updates pushed instead of polling?
- Yes. Webhooks are included on every paid plan (Starter, Growth, Pro, Business, Scale). WebSocket is included on paid plans, and the Free plan gets a 500-message monthly preview. Both can be filtered to nhl.