Nba Data
Wire live NBA scores, standings, rosters, and box scores into sports apps or content sites without hand-rolling ESPN-style HTTP calls.
Overview
NBA Data is an agent skill for the Build phase that documents Machina Sports NBA API commands for scores, standings, rosters, schedules, box scores, leaders, and news.
Install
npx skills add https://github.com/machina-sports/sports-skills --skill nba-dataWhat is this skill?
- Eight documented commands: scoreboard, standings, teams, roster, schedule, game summary, leaders, and news
- Live and historical games via optional date and season parameters
- Team-scoped roster and schedule using ESPN team IDs (e.g. Lakers "13")
- Game summary returns box score, scoring plays, and leaders per event_id
- Standings include W-L, PCT, GB, streak, and split records by conference
- 8 API commands documented
- 30 NBA teams via get_teams
Adoption & trust: 513 installs on skills.sh; 134 GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You are building a sports feature but lack a single, agent-readable map of NBA endpoints, IDs, and return fields.
Who is it for?
Indie builders adding NBA widgets, bots, or internal dashboards on top of a packaged sports data API.
Skip if: Teams that need proprietary odds models, offline-only datasets, or leagues other than NBA without extending the upstream package.
When should I use this skill?
Building or extending features that need NBA scoreboards, schedules, rosters, leaders, or filtered news from the Machina Sports NBA API.
What do I get? / Deliverables
Your agent issues consistent get_scoreboard, get_standings, and get_game_summary calls with the right team_id, event_id, and date filters and interprets the returned structures.
- Correctly parameterized API calls
- Parsed events, standings, box scores, or news article lists in app code
Recommended Skills
Journey fit
Canonical shelf is Build because the skill is an API command reference for integrating external sports data into a product you are implementing. Integrations subphase fits data-fetch commands (scoreboard, schedules, game summaries) that plug into backends, agents, or dashboards.
How it compares
API integration reference for Machina Sports commands—not a general web-scraping or ML forecasting skill.
Common Questions / FAQ
Who is nba-data for?
Solo and indie developers using AI coding agents to integrate NBA scores, standings, and player stats into apps, agents, or content workflows.
When should I use nba-data?
During Build when wiring live scoreboards, team pages, or game recap features; optionally during Grow when automating news or leaderboard content that needs fresh league data.
Is nba-data safe to install?
Treat it as documentation that may trigger network calls to third-party sports APIs; review the Security Audits panel on this Prism page and your data vendor terms before production use.
SKILL.md
READMESKILL.md - Nba Data
# NBA Data — API Reference ## Commands ### get_scoreboard Get live/recent NBA scores. - `date` (str, optional): Date in YYYY-MM-DD format. Defaults to today. Returns `events[]` with game info, scores, status, and competitors. ### get_standings Get NBA standings by conference. - `season` (int, optional): Season year Returns `groups[]` with Eastern/Western conferences and team standings including W-L, PCT, GB, streak, home/away/conference records, and PPG. ### get_teams Get all 30 NBA teams. No parameters. Returns `teams[]` with id, name, abbreviation, logo, and location. ### get_team_roster Get full roster for a team. - `team_id` (str, required): ESPN team ID (e.g., "13" for Lakers) Returns `athletes[]` with name, position, jersey number, height, weight, experience. ### get_team_schedule Get schedule for a specific team. - `team_id` (str, required): ESPN team ID - `season` (int, optional): Season year Returns `events[]` with opponent, date, score (if played), and venue. ### get_game_summary Get detailed box score and scoring plays. - `event_id` (str, required): ESPN event ID Returns `game_info`, `competitors`, `boxscore` (stats per player), `scoring_plays`, and `leaders`. ### get_leaders Get NBA statistical leaders (points, rebounds, assists, etc.). - `season` (int, optional): Season year Returns `categories[]` with leader rankings per stat category. ### get_news Get NBA news articles. - `team_id` (str, optional): Filter by team Returns `articles[]` with headline, description, published date, and link. ### get_play_by_play Get full play-by-play data for a game. - `event_id` (str, required): ESPN event ID Returns play-by-play detail including period, clock, team, play description, and scoring plays. ### get_win_probability Get win probability chart data for a game. - `event_id` (str, required): ESPN event ID Returns timestamped home/away win probability percentages throughout the game. ### get_schedule Get NBA schedule for a specific date or season. - `date` (str, optional): Date in YYYY-MM-DD format - `season` (int, optional): Season year (used only if no date provided) Returns `events[]` for the specified date. ### get_injuries Get current NBA injury reports across all teams. No parameters. Returns `teams[]` with per-team injury lists including player name, position, status (Out/Doubtful/Questionable/Day-To-Day), injury type, and detail. ### get_transactions Get recent NBA transactions (trades, signings, waivers). - `limit` (int, optional): Max transactions to return. Defaults to 50. Returns `transactions[]` with date, team, and description. ### get_futures Get NBA futures/odds markets (Championship winner, MVP, etc.). - `limit` (int, optional): Max entries per market. Defaults to 25. - `season_year` (int, optional): Season year. Defaults to current. Returns `futures[]` with market name and entries (team/player name + odds value). ### get_depth_chart Get depth chart for a specific team. - `team_id` (str, required): ESPN team ID Returns `charts[]` with positional depth and player depth order. ### get_team_stats Get full team statistical profile for a season. - `team_id` (str, required): ESPN team ID - `season_year` (int, optional): Season year. Defaults to current. - `season_type` (int, optional): 1=preseason, 2=regular (default), 3=postseason. Returns `categories[]` with detailed stats including value, rank, and per-game averages. ### get_player_stats Get full player statistical profile for a season. - `player_id` (str, required): ESPN athlete ID - `season_year` (int, optional): Season year. Defaults to current. - `season_type` (int, optional): 1=preseason, 2=regular (default), 3=postseason. Returns `categories[]` with detailed stats including value, rank, and per-game averages. ## Team IDs | Team | ID | Team | ID | |------|-----|------|-----| | Atlanta Hawks | 1 | Memphis Grizzlies | 29 | | Boston Celtics | 2 | Miami Heat | 14 | | Brooklyn Nets | 17 | Milwaukee Bucks | 15 | | Charlotte Hor