Fantasy Football Intelligence Bridge

A read-only JSON API that turns multiple Sleeper (and, once authorized, Yahoo) fantasy football leagues into self-describing documents an AI can fetch and reason about: rosters, scoring, projections, draft help, and a weekly decision engine (lineup, start/sit, matchup, waivers). Every request operates on exactly one league — nothing is merged.

AI assistants: start here

/api/ai — one endpoint that describes the whole service: leagues, known managers, every capability, and concrete route templates. Follow the links it returns; don't guess URLs.

Human-readable overview: /ai — what the bridge is, the leagues and managers it covers, and every analysis capability, in plain HTML.

Also: /llms.txt (plain-text guide), /sitemap.xml, /robots.txt.

Canonical routing hierarchy

/api/ai
  -> /api/leagues
    -> /api/leagues/{leagueSlug}
      -> /api/leagues/{leagueSlug}/managers
        -> /api/leagues/{leagueSlug}/managers/{managerSlug}
          -> specific analysis capability

League identity is not manager identity. The league slug selects the league; the manager slug selects a team owner inside it. Membership is validated live — a non-member manager returns an error, never a different manager.

Known manager routes

/api/leagues/bloodline-bowl/managers/supyo29 — supyo29 (Sleeper: Supyo29), league bloodline-bowl
/api/leagues/bloodline-bowl/managers/bijimac — bijimac (Sleeper: BijiMac), league bloodline-bowl
/api/leagues/devoted-to-the-game/managers/darthmarker — darthmarker (Sleeper: DarthMarker), league devoted-to-the-game

Leagues

bloodline-bowl — Bloodline Bowl · sleeper · READY · default
devoted-to-the-game — Devoted to the Game · sleeper · READY
sportys-alumni — Sporty's Alumni · sleeper · READY
maclin-on-chicks-xvi — Maclin on Chick's XVI · yahoo · LIVE_VALIDATION_REQUIRED
rogers-park — Rogers Park · yahoo · LIVE_VALIDATION_REQUIRED

Analysis capabilities

/api/leagues [service] — League discovery
/api/leagues/{leagueSlug} [league] — League overview
/api/leagues/{leagueSlug}/managers [league] — Manager directory
/api/leagues/{leagueSlug}/managers/{managerSlug} [manager] — Manager home + roster
/api/context/{leagueSlug}/{managerSlug} [manager] — Manager analytical context
/api/league/{leagueSlug}/state [league] — Canonical league state
/api/leagues/{leagueSlug}/scoring [league] — Scoring rules + analysis
/api/leagues/{leagueSlug}/projections [league] — League projections
/api/leagues/{leagueSlug}/projections/{playerId} [league] — Single-player projection
/api/leagues/{leagueSlug}/managers/{managerSlug}/projections [manager] — Need-weighted manager projections
/api/leagues/{leagueSlug}/draft [league] — League draft state
/api/leagues/{leagueSlug}/managers/{managerSlug}/draft [manager] — Personalized draft context
/api/leagues/{leagueSlug}/managers/{managerSlug}/recommendations [manager] — Snake-draft recommendation engine
/api/leagues/{leagueSlug}/snapshot [league] — League snapshot
/api/leagues/{leagueSlug}/managers/{managerSlug}/snapshot [manager] — Personalized snapshot
/api/intelligence/{leagueSlug}/{managerSlug}/week/{week} [manager-week] — Weekly intelligence (combined decision layer)
/api/lineup/{leagueSlug}/{managerSlug}/week/{week} [manager-week] — Optimal lineup + start/sit
/api/matchup/{leagueSlug}/{managerSlug}/week/{week} [manager-week] — Matchup analysis
/api/waivers/{leagueSlug}/{managerSlug}/week/{week} [manager-week] — Waiver / add-drop engine
/api/transactions/{leagueSlug} [league] — Transaction ledger
/api/history/{leagueSlug}/week/{week} [league] — Historical weekly snapshots
/api/providers [service] — Provider + persistence readiness
/api/football-intel/players/{playerId}/progression [service] — Receiver target progression
/api/player-scheme [service] — Player-Scheme index + manifest
/api/player-scheme/players/{playerId} [service] — Player-Scheme player profile
/api/player-scheme/matchups/{playerId}/{opponent} [service] — Player-Scheme player-vs-defense descriptors
/api/player-scheme/teams/{team}/offense [service] — Player-Scheme team offense profile
/api/player-scheme/teams/{team}/defense [service] — Player-Scheme team defense profile
/api/league/{league}/market?week={week}&view={summary|pool} [league] — League market state (who is actually acquirable)
/api/leagues/{leagueSlug}/roster-health [league] — Roster health (league)
/api/leagues/{leagueSlug}/managers/{managerSlug}/roster-health [manager] — Roster health (manager)
/api/leagues/{leagueSlug}/schedule-planning [league] — Schedule planning (league)
/api/leagues/{leagueSlug}/managers/{managerSlug}/schedule-planning [manager] — Schedule planning (manager)
/api/leagues/{leagueSlug}/orchestrate [league] — Team-management orchestrator (league)
/api/leagues/{leagueSlug}/managers/{managerSlug}/orchestrate [manager] — Team-management orchestrator (manager)
/api/football-intel/startsit-evidence [service] — Start/Sit shadow evidence diagnostics
/api/evidence [service] — Book-Ready evidence retrieval
/api/trades/competitive [league] — Competitive trade intelligence

Legacy compatibility

The older ?league=<slug> query-form routes (e.g. /api/league?league=bloodline-bowl, /api/draft, /api/scoring, /api/snapshot) still work but are legacy. Prefer the canonical path routes above. /api/ai lists which capabilities are only available in the legacy form.

Source & methodology

Public repository: github.com/supyo29/bloodline-bowl. GitHub is for inspecting how the numbers are produced — it is not required to use the live bridge.

→ Draft Bridge — interactive, league-isolated draft-night board.