Skip to content

SPORTS

MLBNFLNBAWNBANHLTennisSoccerGolfUFC

PLATFORM

Historical CoverageLive NetworkSports NetworkDevelopersAPI ReferenceDocsPricingEnterprise

ACCOUNT

Manage subscription Get API Key →

NBA API

Shot coordinates, advanced box scores, standings and teams.

Game-level NBA detail — play-by-play with court coordinates, shot charts, reconstructed lineups and box scores with computed TS% and USG% — plus standings, teams, rosters, team schedules and team stats.

Compare all plans
Documented routes19
Base path/nba
Hostpropsports.proptechusa.ai/v1
Live cacheLive list up to 5 min · schedule 1 min

01 Why NBA

Game-level basketball detail — shot coordinates, lineups and advanced box scores.

Built for

  • Shot-chart visualizationsCourt-coordinate plays ready to plot.
  • Game-center productsSummary, box score, plays and lineups per game.
  • Player analysisEfficiency metrics computed per game.
  • Live score appsSlate and live games.
  • Team pagesStandings, rosters, schedules and team stats per club.

Shot coordinates

Every made and missed shot with court x/y, plus a ready shot chart.

Reconstructed lineups

On-court five rebuilt from starters and substitutions (estimates, labelled as such).

Advanced box scores

Box scores with computed TS% and USG%.

Win-probability series

Available per-game win-probability points.

Standings and teams

Conference standings, all 30 teams, team profiles, rosters, team schedules and team statistics.

02 Historical depth

NBA history: 1994–2026.

Box scores back to the mid-1990s and play-by-play from the 2001-02 season, on the same game routes as tonight's games.

Event detail available now

  • Play-by-play Live via APIEvery play with period, clock, score, participants and court coordinates; shot chartLive on PropBetEdge: Live games on PropBetEdgeAPI: Live and completed games through the same routes/nba/game/:id/plays /nba/game/:id/shotchart
Data layerVerified spanDepthDeliveryRoutes
Box scores1994–2026Player lines with computed TS% and USG%; schedules by date find the game IDs.On-demand source/nba/game/:id/boxscore
/nba/schedule?date=
Play-by-play2002–2026Every play with period, clock, score and participants; a November 2002 Lakers–Cavaliers game returns 465 plays.On-demand source/nba/game/:id/plays

Lakers at Cavaliers, 5 Nov 2002

curl -H "X-API-Key: $PROPSPORTS_KEY" \
  "https://propsports.proptechusa.ai/v1/nba/game/221105005/plays?limit=1000"

465 plays returned through the production API.

Known gaps

  • Play-by-play is unavailable before the 2001-02 season; early-era plays carry no court coordinates.
  • Schedules before 1994 are incomplete.

03 Live now

NBA on the network, right now.

A real event read from the same open route customers call, refreshed every 15 seconds. Open it in NBACast for the full live cast.

Connecting…

04 Capabilities

What the NBA API covers.

Schedule & live

  • Schedule & slate
  • Live games
  • Game lines

Play-by-play & game

  • Plays with coordinates
  • Shot chart
  • Box score
  • Game summary

Players

  • Player stats
  • League leaders
  • Rosters

Teams & standings

  • Standings
  • Teams
  • Team profiles
  • Rosters
  • Team schedules
  • Team stats

Advanced

  • Shot coordinates
  • Win-probability series
  • Hustle box

Models & DNA

  • Computed TS% & USG%
  • Reconstructed on-court lineups

05 Endpoints

19 documented NBA routes.

Every NBA route in the production catalog, all GET on https://propsports.proptechusa.ai/v1.

Schedule & live 3

  • GET
    /nba/scheduleScoreboard by date (playoffs, then regular season)
  • GET
    /nba/schedule/todayToday's slate
  • GET
    /nba/games/liveGames in progress

Game detail 7

  • GET
    /nba/game/:id/summaryGame summary with header
  • GET
    /nba/game/:id/boxscoreNormalized box score with computed TS% and USG%
  • GET
    /nba/game/:id/playsPlay-by-play with court coordinates and event category
  • GET
    /nba/game/:id/shotchartMade and missed shots with x/y coordinates
  • GET
    /nba/game/:id/lineupOn-court five reconstructed from starters and substitutions (estimated)
  • GET
    /nba/game/:id/winprobAvailable game win-probability series
  • GET
    /nba/game/:id/hustleHustle box when the source allows it (may return available:false)

Teams & standings 6

  • GET
    /nba/standingsConference standings
  • GET
    /nba/teamsAll 30 teams
  • GET
    /nba/team/:idTeam profile
  • GET
    /nba/team/:id/rosterCurrent roster
  • GET
    /nba/team/:id/scheduleTeam schedule and results
  • GET
    /nba/team/:id/statsTeam statistics

Players & markets 3

  • GET
    /nba/leadersLeague leaders (?stat, ?season)
  • GET
    /nba/player/:id/statsYear-over-year player stats
  • GET
    /nba/oddsGame lines

06 Example

Example request and response.

Captured from production.

GET
Loading example…

  

07 Data notes

Depth and availability.

Where the data comes from, and what it deliberately does not claim.

  • COVERAGEGame summaries, standings, team and player records
  • ACCESSSingle Sport ($29/mo), Developer (up to 3 sports, $79/mo) or any all-sports plan from $149/mo. Every plan that covers NBA includes all 19 routes.
  • NOTELineups are reconstructed from starters and substitutions and are estimates.
  • NOTEThe hustle box may return available:false.
  • NOTEWin probability is an available game series, not a PropSports model.