# Fanfare

> Real-time sports intelligence for the full fan experience. Schedules, scores, venues, weather, neighborhood discovery, and travel planning across MLB, NBA, WNBA, NHL, NFL, and other major sports.

## Product Pillars

Fanfare is organized around four pillars. Every endpoint is reachable at its pillar path (shown) and an unchanged legacy path:
- Live Events (/v1/live-events/*) — game-day & trip bundles: tickets, travel, weather, dining in one call.
- Fantasy & Betting (/v1/fantasy-betting/*) — DFS inputs and betting context: projections, lineups, Vegas lines, park factors, weather impact.
- Digital & Social (/v1/content/*) — content & analytics: highlights, narratives, headlines, charts, milestone context.
- Atomics (/v1/atomic/*) — raw per-sport primitives (schedules, scores, standings, players, venues) the bundles compose.

## Reference Agent

Sample agents showing end-to-end Fanfare integration with automatic x402 payments:
- GitHub: https://github.com/roostersbi/fanfare-agent
- Python / LangGraph: game-night planner + World Cup trip planner
- TypeScript / Vercel AI SDK: same examples, one-command quickstart

## Access

All data endpoints require payment via the x402 protocol (USDC on Base, pay-per-request).

- Agent card (A2A): /.well-known/agent.json
- Standard price: $0.001 USDC per request
- Live game feed price: $0.005 USDC per request
- Flights + hotels search: $0.25 USDC per request (Duffel-powered)
- Protocol: x402 with EIP-3009 transferWithAuthorization

## Bundles

- GET /v1/game-night-bundle — Single-game evening plan: game info + recommended arrival time + Ticketmaster tickets + weather + top 3 nearby restaurants in one call. Covers MLB, NBA, WNBA, NHL, NFL. Params: sport, team_id, date. — $0.05
- GET /v1/game-trip-bundle — Full away-game trip plan: game-night-bundle + one-way Duffel flights from origin + hotel search near stadium. Params: sport, team_id, date, origin (IATA), check_in, check_out, passengers, guests. — $0.50
- GET /v1/playoff-tracker — Team's next 7–14 days of games with playoff/regular-season flag + Ticketmaster tickets for next home game. Works year-round across MLB, NBA, WNBA, NHL, NFL. Params: sport, team_id. — $0.05
- GET /v1/team-profile-bundle — Team snapshot: current standings (wins, losses, division rank) + next 3 upcoming games + Ticketmaster tickets for next home game. Works year-round for MLB, NBA, WNBA, NHL, NFL. Params: sport, team_id. — $0.05
- GET /v1/player-spotlight-bundle — Player profile + team's next home game + Ticketmaster tickets in one call. Supported: MLB, NBA, WNBA, NHL (not NFL). player_id: MLB Stats API ID for mlb; ESPN ID for nba/wnba/nhl. Params: sport, player_id. — $0.05
- GET /v1/rivalry-bundle — Next matchup between two teams + standings for both + tickets at the home venue + weather. Scans next 7–14 days. Params: sport, team_id, opponent_id. — $0.05

## MLB — Major League Baseball

- GET /mlb/schedule — game schedule for any date or team (filter: date, teamId)
- GET /mlb/standings — division standings (filter: leagueId 103=AL, 104=NL)
- GET /mlb/teams — all 30 teams with IDs and divisions
- GET /mlb/players — active roster for current season
- GET /mlb/player/:player_id — full season hitting, pitching, and fielding stats
- GET /mlb/game/:game_pk — live play-by-play game feed (premium)
- GET /mlb/venues — all 30 ballparks with capacity and surface
- GET /mlb/venue-nearby — restaurants, bars, parking near a ballpark (params: venueId, type)
- GET /mlb/venue-weather — real-time weather at a ballpark (params: venueId)
- GET /mlb/tickets — Ticketmaster listings for an upcoming home game (params: teamId, date)
- GET /mlb/flights — one-way flight search to the team's nearest airport via Duffel (params: teamId, date, origin, passengers) — $0.25
- GET /mlb/hotels — hotel search near the team's stadium via Duffel Stays (params: teamId, check_in, check_out, guests) — $0.25

## NBA — National Basketball Association

- GET /nba/schedule — game schedule for any date
- GET /nba/standings — conference standings
- GET /nba/teams — all 30 teams
- GET /nba/players — active roster
- GET /nba/player/:player_id — season stats by ESPN player ID
- GET /nba/game/:game_id — live game detail (premium)
- GET /nba/venue-nearby — nearby places for any arena (params: teamId, type)
- GET /nba/venue-weather — weather near any arena (params: teamId)
- GET /nba/tickets — Ticketmaster listings (params: teamId, date)
- GET /nba/flights — flight search to the team's nearest airport via Duffel (params: teamId, date, origin, passengers) — $0.25
- GET /nba/hotels — hotel search near the team's arena via Duffel Stays (params: teamId, check_in, check_out, guests) — $0.25

## WNBA — Women's National Basketball Association

- GET /wnba/schedule — game schedule for any date
- GET /wnba/standings — conference standings
- GET /wnba/teams — all teams
- GET /wnba/players — active roster
- GET /wnba/player/:player_id — season stats by ESPN player ID
- GET /wnba/venue-nearby — nearby places for any arena (params: teamId, type)
- GET /wnba/venue-weather — weather near any arena (params: teamId)
- GET /wnba/tickets — Ticketmaster listings (params: teamId, date)
- GET /wnba/flights — flight search to the team's nearest airport via Duffel (params: teamId, date, origin, passengers) — $0.25
- GET /wnba/hotels — hotel search near the team's arena via Duffel Stays (params: teamId, check_in, check_out, guests) — $0.25

## NHL — National Hockey League

- GET /nhl/schedule — game schedule for any date
- GET /nhl/standings — division and conference standings
- GET /nhl/teams — all 32 teams
- GET /nhl/player/:player_id — season stats (goals, assists, plus/minus)
- GET /nhl/game/:game_id — live game feed with period and clock (premium)
- GET /nhl/venue-nearby — nearby places for any arena (params: teamId, type)
- GET /nhl/venue-weather — weather near any arena (params: teamId)
- GET /nhl/tickets — Ticketmaster listings (params: teamId, date)
- GET /nhl/flights — flight search to the team's nearest airport via Duffel (params: teamId, date, origin, passengers) — $0.25
- GET /nhl/hotels — hotel search near the team's arena via Duffel Stays (params: teamId, check_in, check_out, guests) — $0.25

## NFL — National Football League

- GET /nfl/schedule — weekly schedule (params: year, week 1-18)
- GET /nfl/scoreboard — scores for any date
- GET /nfl/standings — division and conference standings
- GET /nfl/teams — all 32 teams
- GET /nfl/game/:event_id — game detail with score and box score
- GET /nfl/venue-nearby — nearby places for any stadium (params: teamId, type)
- GET /nfl/venue-weather — weather at any stadium (params: teamId)
- GET /nfl/tickets — Ticketmaster listings (params: teamId, date)
- GET /nfl/flights — flight search to the team's nearest airport via Duffel (params: teamId, date, origin, passengers) — $0.25
- GET /nfl/hotels — hotel search near the team's stadium via Duffel Stays (params: teamId, check_in, check_out, guests) — $0.25