nba-data

US Sports Open source · MIT Read-only 28 commands 952 installs

NBA data via ESPN public endpoints, the NBA live CDN, and NBA Stats (stats.nba.com) — scores, standings, rosters, schedules, game summaries, play-by-play, injuries, futures, depth charts, leaders, and news, plus an analytics backend: advanced ratings, per-shot court coordinates, career splits, and history to 1946. Zero config, no API keys.

View source

Commands 28

get_scoreboard

[--date]

Live/recent NBA scores

get_standings

[--season]

Standings by conference

get_teams

All 30 NBA teams

get_team_roster

--team_id

Full roster for a team

get_team_schedule

--team_id[--season][--season_type]

Schedule for a specific team

get_game_summary

--event_id

Detailed box score and scoring plays

get_leaders

[--season]

NBA statistical leaders

get_news

[--team_id]

NBA news articles

get_play_by_play

--event_id

Full play-by-play for a game

get_win_probability

--event_id

Win probability chart data

get_schedule

[--date][--season]

Games on a specific date (no season filter; see get_team_schedule)

get_injuries

Injury reports across all teams

get_transactions

[--limit]

Recent transactions

get_futures

[--limit][--season_year]

Futures/odds markets

get_depth_chart

--team_id

Depth chart for a team

get_team_stats

--team_id[--season_year][--season_type]

Team statistical profile

get_player_stats

--player_id[--season_year][--season_type]

Player statistical profile

find_nba_player

--name

Search the NBA Stats player registry (all eras)

get_nbastats_game_log

[--season][--team][--season_type][--player_or_team][--player][--sort_by][--descending][--limit][--fields]

League game log via NBA Stats — history to 1946, carries NBA game ids. player_or_team="player" or player=<name or id> for player game logs

get_nbastats_player_career

[--player_id][--player][--per_mode]

Career stats season by season via NBA Stats

get_nbastats_team_stats

[--season][--team][--measure][--per_mode][--season_type][--sort_by][--descending][--limit][--fields]

League team stats via NBA Stats — advanced ratings, pace, four factors

get_nbastats_shot_chart

[--player_id][--player][--season][--season_type][--sort_by][--descending][--limit][--fields]

Per-shot court coordinates via NBA Stats

get_nbastats_play_by_play

--game_id[--limit]

Play-by-play with coordinates for past seasons via NBA Stats

get_nbastats_advanced_boxscore

--game_id

Advanced box score (ratings, usage) via NBA Stats

get_live_scoreboard

Real-time scores. Primary cdn.nba.com, fallback ESPN

get_live_boxscore

--game_id

Real-time box score. Primary cdn.nba.com, fallback ESPN

get_live_playbyplay

--game_id[--limit][--scoring_only]

Real-time play-by-play, most recent plays first

get_player_live_stats

--player_name

Real-time stats for one player in today's games

Example Prompts

What are today's NBA scores?
Show me the Western Conference standings
Who's on the Lakers roster?
Show me the full box score for last night's Celtics game
Who's injured on the Lakers?

Quick Start

# CLI

sports-skills nba get_scoreboard

# Python

from sports_skills import nba
nba.get_scoreboard()

nba-data

Commands 28

Example Prompts

Quick Start

More in US Sports