← DunkAPICONTENT HISTORY

Update to DunkAPI

Snapshot Oct 31, 2026 · 01:21 UTC · version 1.0.0

Collection source: downloaded plugin package.

WHAT CHANGED

First saved snapshot

No earlier snapshot is available to establish a change.

Save DunkAPI and check future changes in Following.

Up to 10 plugins free · no card required.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "description": "Finds basketball games and reads results: scores by date, team, range or season, upcoming schedule, and a single game's full box score. Use when the user asks who played, what the score was, who plays tonight, a team's recent results, or wants a game id for another call. Covers NBA, WNBA, men's and women's college. Do not use for odds comparison, see odds-explorer. Do not use for team strength, see team-analysis. Do not use for a pre-game breakdown, see game-preview.",
  "included_files": [],
  "name": "game-lookup",
  "skill_md_contents": "---\nname: game-lookup\ndescription: \"Finds basketball games and reads results: scores by date, team, range or season, upcoming schedule, and a single game's full box score. Use when the user asks who played, what the score was, who plays tonight, a team's recent results, or wants a game id for another call. Covers NBA, WNBA, men's and women's college. Do not use for odds comparison, see odds-explorer. Do not use for team strength, see team-analysis. Do not use for a pre-game breakdown, see game-preview.\"\nmetadata:\n  version: 1.0.0\n  author: DunkAPI\n---\n\n# Game Lookup\n\n> **Default data tool:** DunkAPI (`dunkapi-tool`).\n> `list_games` (2 credits) for results, `get_schedule` (2) for upcoming games, `get_game` (5) for one game in full.\n\nYou find the right game fast and return it cleanly. Most other skills need a `game_id` first; this one produces it.\n\n## When to Use\n\n- \"What was the score of the Knicks game?\" / \"Last night's NBA results\"\n- \"Who plays tonight?\" / \"Celtics schedule this week\"\n- \"Show me the box score for that game\"\n- \"Every Lakers road game this season\"\n- Any request that needs a `game_id` before another skill can run\n\n## When NOT to Use\n\n- Comparing sportsbooks or reading line moves, see `odds-explorer`\n- Ranking teams or reading efficiency, see `team-analysis`\n- A full matchup breakdown with injuries and ratings, see `game-preview`\n- Shot-level detail from a game, see `shot-zone-analysis`\n\n## Commands Available\n\n| Command | What it does | Credits |\n|---------|-------------|---------|\n| `list_teams` | Team ids and abbreviations for a season | 1 |\n| `list_games` | Games with scores by season, date, range or team, newest first | 2 |\n| `get_schedule` | Next 1-30 days with the median spread, total and moneylines | 2 |\n| `get_game` | One game: team box scores, every player line, each book's open and close, win-probability range | 5 |\n\n## Commands That Do NOT Exist\n\n| Not available | Use instead |\n|---------------|-------------|\n| `get_box_score` | `get_game` |\n| `get_scoreboard` | `list_games` with `date` (finals) or `get_schedule` (upcoming) |\n| `get_live_scores` | None. Data is historical and next-day, not live |\n| `get_head_to_head` | `list_games` with `team`, then filter the opponent in code |\n\n## Season Resolution\n\n- `season` is the year the season ends: 2025-26 is `2026`, 2026-27 is `2027`.\n- Oct 20, 2026 is the NBA opener. Before it, `get_schedule` returns `preseason` games tagged `season: 2027`.\n- WNBA is the calendar year. `season_type` values: `regular`, `postseason`, `play_in`, `preseason`.\n- Dates are US Eastern. A 10:30 pm ET tip can have a UTC `starts_at` on the next day; filter by the `date` field, not `starts_at`.\n\n## How It Works\n\n**Step 1: Resolve the team.** If the user says \"the Knicks\" and you do not have the abbreviation, call `list_teams` (1 credit). The API accepts an id or an abbreviation (`NY`, `BOS`, `GS`, `SA`). Do not guess; `GS` and `NY` are the codes here, not `GSW` or `NYK`.\n\n**Step 2: Pick the listing call.**\n\n| Question | Call |\n|----------|------|\n| Last night's scores | `list_games` with `date` set to yesterday |\n| A team's recent games | `list_games` with `team` and `limit` |\n| A playoff series | `list_games` with `team`, `season`, `season_type: \"postseason\"` |\n| A date range | `list_games` with `from` and `to` |\n| Tonight and the week | `get_schedule` with `days` and optionally `team` |\n\n**Step 3: Get the box score only when needed.** `list_games` already has the score, venue and overtime count. Call `get_game` (5 credits) for player lines, team box scores, books' lines or the win-probability range.\n\n**Step 4: Present it.** Lead with the answer (score, winner, margin), then the detail.\n\n### Live example\n\n`list_games {\"team\": \"NY\", \"season\": 2026, \"limit\": 3}` returned the latest postseason games (NY vs SA, June 2026), newest first. Trimmed:\n\n```json\n{\"data\": {\"games\": [\n  {\"game_id\": \"401859967\", \"season\": 2026, \"season_type\": \"postseason\",\n   \"date\": \"2026-06-13\", \"status\": \"final\",\n   \"home\": {\"abbrev\": \"SA\", \"score\": 90}, \"away\": {\"abbrev\": \"NY\", \"score\": 94},\n   \"periods\": 4, \"overtime_periods\": 0, \"venue\": \"Frost Bank Center\"}\n ], \"count\": 3, \"next_offset\": 3}}\n```\n\nPass `next_offset` back as `offset` for the next page. Paging past 50 games (the default `limit`) costs 2 credits per page.\n\n### What `get_game` returns\n\n- `game`: score, venue, attendance, periods\n- `team_stats`: per team `pts fgm fga tpm tpa ftm fta oreb dreb reb ast stl blk tov pf fast_break_pts paint_pts points_off_turnovers largest_lead`\n- `players`: per player `minutes pts fgm fga tpm tpa ftm fta oreb dreb reb ast stl blk tov pf plus_minus`, plus `starter` and `did_not_play`\n- `odds`: per book opening and closing moneyline, spread and total\n- `win_probability`: `home_min`, `home_max`, `plays_with_probability`\n\n## Reading a box score\n\n- **Possessions** ~ `fga - oreb + tov + 0.44 * fta` (same formula the API uses for ratings). Points per possession is a better efficiency read than raw points.\n- **True shooting** = `pts / (2 * (fga + 0.44 * fta))`.\n- **Effective FG%** = `(fgm + 0.5 * tpm) / fga`.\n- Compare `paint_pts`, `fast_break_pts` and `points_off_turnovers` to see how a team scored, not just how much.\n- `plus_minus` in a single game is noisy. Do not rank players on it.\n- A very wide `home_min` to `home_max` win-probability range means the lead changed hands; a narrow band means a wire-to-wire game.\n\n## Gotchas\n\n| Gotcha | Handling |\n|--------|----------|\n| `list_games` is newest first | Reverse before computing rolling stats |\n| Postseason, play-in and preseason are separate | Filter `season_type` or you mix preseason with real games |\n| Scheduled games have `score: null` | Do not treat null as zero |\n| Overtime games | Check `overtime_periods`; per-game totals and pace need adjusting |\n| A game with no line | `line.books` can be 1 or 0 on preseason games; do not call it \"the market\" |\n\n## Credit Usage\n\n| Operation | Credits |\n|-----------|---------|\n| Look up a team abbreviation | 1 |\n| One page of results (up to 50 games) | 2 |\n| Tonight's slate | 2 |\n| One full box score | 5 |\n| Every box score for a 6-game series | 30 |\n\n## Output Format\n\n```\nNew York Knicks 94, San Antonio Spurs 90 (Final, Jun 13 2026)\nFrost Bank Center | Postseason | game_id 401859967\n\nTop lines: [player] [pts], [fgm]-[fga] FG, [tpm]-[tpa] 3P, [ftm]-[fta] FT\n```\n\n## What to Do Next\n\n| Found | Next | Skill |\n|-------|------|-------|\n| A game to analyze before tip | Full preview | `game-preview` |\n| A game with lines | Compare books | `odds-explorer` |\n| Shot detail | Zone profile for the game | `shot-zone-analysis` |\n| A player's big night | Context against his average | `player-form` |\n"
}

SHA-256 of public snapshot: 7904eabc42dc52bd1e8d10125a2d06edf41763320882b5b61d19b6fc4c5b3d6b