Basketball API.

Quick start

All endpoints under /basketball/api/v2/. Authentication via DRF token in the Authorization header. The Sports Pack ($5/mo) unlocks tennis, basketball, hockey, darts, and CS:GO API + MCP access.

Model: CatBoost trained on 4,000+ events with ~35 features (ELO, recent form 5/10, home/away splits, rest days, back-to-back flag, head-to-head, rolling eFG%/TS%, pace, league id). Per-tier calibration: NBA isotonic, EuroLeague/ACB/Lega A/BBL Platt-scaled, Eurocup falls back to global. Markets: has_winner (AUC≈0.78), over_total_215 (AUC≈0.92), over_total_205, over_total_225, favorite_wins. Retrained weekly.

GET/basketball/api/v2/leagues/

List active basketball leagues.

Param	Type	Description
country	str	Filter by country (e.g. USA, Spain)
limit	int	Default 50, max 200

GET/basketball/api/v2/teams/

List teams sorted by ELO. Filter by country code.

GET/basketball/api/v2/events/

List events. Default returns next 7 days.

Param	Type	Description
date_from	YYYY-MM-DD	Start of date window
date_to	YYYY-MM-DD	End of date window
league	int / str	League id or name
team	int / str	Team id or name (filters home OR away)
status	str	scheduled / live / finished

GET/basketball/api/v2/events/<id>/

Single event with periods + prediction.

GET/basketball/api/v2/events/<id>/box-score/

Per-player box score (PTS / REB / AST / STL / BLK / TO / FG / 3P / FT / +/- / TS% / rating). Starters marked. Split into home_box + away_box.

GET/basketball/api/v2/events/<id>/team-stats/

Team-level scoring/rebound/lead breakdown by quarter + game-total. Each entry has name, home, away.

GET/basketball/api/v2/events/<id>/pregame/

Pre-game bundle for a scheduled event — head coaches, venue (with capacity + city), current season standings position for both teams, form streaks (first-quarter winner, scored avg last 10, game points avg, H2H trends), and featured players to watch with their last-game stat line.

GET/basketball/api/v2/standings/?league=<id>

League standings table for the current season. Each row exposes position, matches, wins, losses, scores_for/against, percentage. Pass ?season=<id> to query a specific season.

GET/basketball/api/v2/managers/

Head coaches. Filter by team id or search name.

GET/basketball/api/v2/venues/

Arenas with capacity, city, country.

GET/basketball/api/v2/players/

List players. Filter by team, country_code, position (G, F, C, GF, CF), or search.

GET/basketball/api/v2/players/<id>/

Player detail with season averages: ppg, rpg, apg, spg, bpg, topg, field_goal_pct, usage_pct, total points.

GET/basketball/api/v2/players/<id>/games/

Recent box-score lines for a player (game log). Default 20, max 100.

GET/basketball/api/v2/predictions/

Upcoming CatBoost predictions sorted by confidence. Each row exposes prob_home_win, prob_over_205, prob_over_215, prob_over_225, prob_favorite_wins (calibrated per league tier), plus ELO values used as input features and the model_version tag.

POST/basketball/mcp/

JSON-RPC 2.0 MCP endpoint. Drops into Claude, ChatGPT, Gemini. Tools: list_leagues, list_teams, search_teams, list_events, get_event, get_predictions, search_players, get_player, get_box_score, get_team_stats, get_pregame, get_standings.

Try it

# Upcoming fixtures
curl -H "Authorization: Token YOUR_KEY" \
  "https://sports.bzzoiro.com/basketball/api/v2/events/?status=scheduled&limit=10"

# Box score for a finished game
curl -H "Authorization: Token YOUR_KEY" \
  "https://sports.bzzoiro.com/basketball/api/v2/events/<event_id>/box-score/"

# Team stats (scoring + rebounds + lead breakdown)
curl -H "Authorization: Token YOUR_KEY" \
  "https://sports.bzzoiro.com/basketball/api/v2/events/<event_id>/team-stats/"

# Player search + recent games
curl -H "Authorization: Token YOUR_KEY" \
  "https://sports.bzzoiro.com/basketball/api/v2/players/?search=Edwards"
curl -H "Authorization: Token YOUR_KEY" \
  "https://sports.bzzoiro.com/basketball/api/v2/players/<player_id>/games/?limit=10"

# ELO predictions
curl "https://sports.bzzoiro.com/basketball/api/v2/predictions/?limit=20"

MCP server

{
  "mcpServers": {
    "basketball": {
      "url": "https://sports.bzzoiro.com/basketball/mcp/",
      "transport": "streamable-http",
      "headers": { "Authorization": "Token YOUR_KEY" }
    }
  }
}

Tracked leagues

League	Country
NBA	USA
Euroleague	Europe
Liga ACB	Spain
Lega A Basket	Italy
Germany BBL	Germany
Eurocup	Europe