Realtime Sports API

Realtime Sports API

Live scores, play-by-play, box scores, schedules, teams, athletes, injuries, news and betting odds for NFL, college football, NBA, men's college basketball,…

Data & analytics#sports--fitness

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Live scores, play-by-play, box scores, schedules, teams, athletes, injuries, news and betting odds
for NFL, college football, NBA, men's college basketball, MLB, NHL and 23 soccer competitions, under one
schema and one API key. Push delivery is available over webhooks and WebSocket.

Freshness: data is aggregated from public sources and is typically 20-30 seconds behind live play
(our pipeline adds about 1 second after our source). Not suitable for in-play betting that needs
sub-second data. There is no SLA.

Auth: send Authorization: Bearer (or X-API-Key: ). Get a free key at
https://www.realtimesportsapi.com/signup?utm_source=openapi.

Quotas: monthly call quotas per plan (Free 125/month, 1,000 in the first 30 days; Starter 10,000;
Growth 25,000; Pro 50,000; Business 150,000; Scale 500,000). Every successful REST call counts as one call. When the quota is
exhausted the API returns HTTP 429 with a Retry-After header. Per-second rates also apply
(Free 1/s, Starter 5/s, Growth 10/s, Pro 20/s, Business 40/s, Scale 100/s). Remaining monthly quota is reported in
meta.rateLimit on most responses.

Endpoints 51

Sports

  • GETList sports/sports
  • GETList leagues for a sport/sports/:sport/leagues
  • GETGet league details/sports/:sport/leagues/:leagueLeague metadata, current season, and links to related endpoints.

Events

  • GETList events for a league/sports/:sport/leagues/:league/eventsCurrent and upcoming events (the provider's current scoreboard window). Pass date=YYYY-MM-DD for one US Eastern day: on daily leagues the default window can…
  • GETList live events/sports/:sport/leagues/:league/events/liveEvents currently in progress (status.state = "in"). Returns an empty array when nothing is live. For continuous updates prefer webhooks or the WebSocket…
  • GETGet an event/sports/:sport/leagues/:league/events/:eventId
  • GETGet box score/sports/:sport/leagues/:league/events/:eventId/boxscoreTeam totals and player stats. Supported for basketball, soccer, baseball and football. Football players carry per-category stats (passing, rushing, receiving,…
  • GETGet win probability/sports/:sport/leagues/:league/events/:eventId/winprobabilityPer-play win probability series (join to plays via playId) plus drive summaries, where the source publishes them. On the Free plan this returns 403…
  • GETGet game rosters/sports/:sport/leagues/:league/events/:eventId/rosterGame-specific rosters with per-player flags (starter, didNotPlay, active). Published by the source at kickoff.

Plays

  • GETGet play-by-play/sports/:sport/leagues/:league/events/:eventId/playsPlays in chronological order, paginated. Use limit up to 1000 to fetch a whole game in one call. On the Free plan this returns 403 LIVE_DATA_REQUIRES_TRIAL…
  • GETGet penalty plays/sports/:sport/leagues/:league/events/:eventId/penaltiesOnly the penalty plays of an event; all plays are scanned, not just one page.

Odds

  • GETGet current odds/sports/:sport/leagues/:league/events/:eventId/oddsCurrent spread, moneyline and total from a single source book. data is null (with a message) when no odds are available.
  • GETGet odds history/sports/:sport/leagues/:league/events/:eventId/odds/historySnapshots recorded each time the line changed, newest first.

Teams

  • GETList teams/sports/:sport/leagues/:league/teamsPaginated. College football has 800+ teams across all divisions; for FBS only use the group endpoint (/seasons/{season}/types/2/groups/80/teams).
  • GETGet a team/sports/:sport/leagues/:league/teams/:teamId
  • GETGet team roster/sports/:sport/leagues/:league/teams/:teamId/rosterCurrent roster grouped by position plus a flat list. Pass season for a historical season roster (flat list).
  • GETGet depth chart/sports/:sport/leagues/:league/teams/:teamId/depthchart

Athletes

  • GETList athletes/sports/:sport/leagues/:league/athletesPaginated. Some leagues have tens of thousands of athletes; prefer team rosters or search.
  • GETSearch athletes by name/sports/:sport/leagues/:league/athletes/search?query=mahomes
  • GETGet an athlete/sports/:sport/leagues/:league/athletes/:athleteIdAthlete profile with statistics. Omit season for career/current totals.
  • GETGet athlete game log/sports/:sport/leagues/:league/athletes/:athleteId/gamelog?season=2026
  • GETGet athlete availability history/sports/:sport/leagues/:league/athletes/:athleteId/availability-historyTime series of a player's injury/availability designations, newest first, as observed by our snapshots (every 5 minutes).

Seasons

  • GETGet the active season/sports/:sport/leagues/:league/season
  • GETList seasons/sports/:sport/leagues/:league/seasons
  • GETGet a season/sports/:sport/leagues/:league/seasons/:season
  • GETGet season schedule/sports/:sport/leagues/:league/seasons/:season/scheduleEvents for a season, optionally one week (NFL and college football only). With week, our synced store (which covers about the next week) is merged with the…
  • GETList weeks in a season/sports/:sport/leagues/:league/seasons/:season/weeksNFL and college football only.
  • GETList season types/sports/:sport/leagues/:league/seasons/:season/types
  • GETGet a season type/sports/:sport/leagues/:league/seasons/:season/types/:typeId
  • GETList groups (conferences/divisions)/sports/:sport/leagues/:league/seasons/:season/types/:typeId/groups
  • GETGet a group/sports/:sport/leagues/:league/seasons/:season/types/:typeId/groups/:groupId
  • GETList teams in a group/sports/:sport/leagues/:league/seasons/:season/types/:typeId/groups/:groupId/teams
  • GETList a team's events in a season/sports/:sport/leagues/:league/seasons/:season/teams/:teamId/events
  • GETGet NCAA tournament games/sports/:sport/leagues/:league/seasons/:season/tournamentNCAA tournament games for a season with region, round and First Four flag. Basketball only; excludes NIT/CBI/CIT.

Injuries & Availability

  • GETGet injury report/sports/:sport/leagues/:league/injuriesCurrent injuries grouped by team. Without team the league-wide feed is truncated by the source to the 25 most recent records per team; with team the complete…
  • GETGet normalized player availability/sports/:sport/leagues/:league/player-availabilityOne normalized availability value per player (OUT, DOUBTFUL, QUESTIONABLE, PROBABLE, DAY_TO_DAY, INJURED_RESERVE, SUSPENDED, AVAILABLE, UNKNOWN).
  • GETGet availability changes feed/sports/:sport/leagues/:league/player-availability/historyLeague-wide feed of availability designation changes, newest first.

Rankings

  • GETGet college polls and rankings/sports/:sport/leagues/:league/rankingsAP Top 25, coaches polls and, for college football, the College Football Playoff rankings, FCS and Division II/III polls. Leagues: football/college-football…

News

  • GETGet latest news/sports/:sport/leagues/:league/newsRolling window of recent articles from the source. For older articles use /news/history.
  • GETGet archived news/sports/:sport/leagues/:league/news/historyOur archive of league news, newest first. The archive begins 2026-09-02.

Transactions

  • GETGet transactions/sports/:sport/leagues/:league/transactionsRecent signings, injured-list moves, call-ups, releases and trades. Empty in the off-season.

Webhooks

  • GETList your webhooks/webhooksRequires a paid plan.
  • POSTCreate a webhook/webhooksDeliveries are signed with HMAC-SHA256 in the X-Webhook-Signature header. The signing secret is returned only in this response (retrieve it later via…
  • GETGet a webhook/webhooks/:webhookId
  • DELETEDelete a webhook/webhooks/:webhookId
  • PATCHUpdate a webhook/webhooks/:webhookIdPartial update of any of url, events, leagues, frequency, active. active: true re-enables an automatically deactivated webhook.
  • GETReveal the signing secret/webhooks/:webhookId/secret
  • POSTRotate the signing secret/webhooks/:webhookId/secretThe old secret stops being used within about one second.
  • POSTSend a test delivery/webhooks/:webhookId/testSends a signed sample payload (header X-Webhook-Test: true), or replays a recorded failed delivery when deliveryId is given.
  • GETList failed deliveries/webhooks/:webhookId/deliveriesRecent failed delivery attempts. Successful deliveries are not recorded individually.

WebSocket

  • POSTGet a WebSocket tokenhttps://www.realtimesportsapi.com/api?utm_source=openapi/websocket/authReturns the WebSocket URL and a token valid for one hour. Connect to ${url}?token=${token}, then send…

API details

Base URL
https://www.realtimesportsapi.com/api/v1
Authentication
A bearer token in the Authorization header
An API key in the X-API-Key header
Operations
51 operations on 47 pathsGET 45POST 4PATCH 1DELETE 1
Main resources
Seasons 12Webhooks 9Events 6Teams 6Athletes 5Injuries & Availability 4Sports 3News 2Odds 2Plays 2
Response formats
application/json
Description format
OpenAPI 3.0.3, API version 1.0.0

How to test the Realtime Sports API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Realtime Sports API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “List sports” (GET /sports), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Realtime Sports API?

Live scores, play-by-play, box scores, schedules, teams, athletes, injuries, news and betting odds for NFL, college football, NBA, men's college basketball,… It is listed under Data & analytics and has 51 endpoints.

Who publishes the Realtime Sports API?

It is listed from Realtime Sports API's public API description (an OpenAPI document), not published by Realtime Sports API on Swastik Codes. Anyone who controls realtimesportsapi.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Realtime Sports API?

Requests go to https://www.realtimesportsapi.com/api/v1. Endpoint paths are added to this base URL.

How do I authenticate with the Realtime Sports API?

It accepts 2 methods: A bearer token in the Authorization header; an API key in the X-API-Key header.

How many endpoints does the Realtime Sports API have?

51 operations on 47 paths (45 GET, 4 POST, 1 PATCH, 1 DELETE). The largest groups are Seasons, Webhooks, Events, Teams.

Is forking the Realtime Sports API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.