# StatEdge

> AI-synthesized sports intelligence API with genuine global coverage — pay-per-query via x402 micropayments on Base.

## What This Is

StatEdge is a sports intelligence API serving both human bettors/fantasy players and AI agents. It synthesizes live data from multiple sources into structured, actionable analysis. Global coverage is real — not just claimed.

Data sources: The Odds API (live betting lines from 20+ sportsbooks, US/UK/EU/AU regions), Jolpica F1 API (live F1 standings and race data, free, no key), ESPN unofficial API (injury reports and scoreboards for all major leagues globally), Tavily real-time search (targeting authoritative sources per sport).

## Supported Sports

North America: NFL, NBA, MLB, NHL, NCAAF, NCAAB, MLS, CFL, WNBA

Global soccer: EPL, La Liga, Bundesliga, Serie A, Ligue 1, Champions League, Europa League, Brasileirão, Liga MX, Eredivisie, A-League, Saudi Pro League, Super Lig, Scottish Premiership, Argentine Primera División

Global sports via /api/global: Formula 1, Cricket (IPL, BBL, PSL, CPL, The Hundred, SA20, Test/ODI/T20I), Rugby Union (Six Nations, Rugby Championship, Super Rugby, Premiership, Top14, URC, Rugby World Cup), Rugby League (NRL, Super League), Tennis (ATP/WTA, Wimbledon, US Open, Australian Open, Roland Garros), AFL, Golf (PGA Tour, DP World Tour, LIV Golf, all Majors), Boxing, MMA/UFC, Cycling (Tour de France, Giro, Vuelta), Athletics, Olympics, EuroLeague, NBL

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Endpoints

GET /api/global?sport={sport}&action={action}&detail={detail}
- The right endpoint for any global sport not in the fantasy/waiver model
- sport: F1|CRICKET|IPL|BBL|PSL|RUGBY|SIXNATIONS|NRL|SUPERLEAGUE|TENNIS|WIMBLEDON|USOPEN|AUSOPEN|AFL|GOLF|BOXING|MMA|UFC|CYCLING|TDF|ATHLETICS|OLYMPICS
- action (F1): race|standings|qualifying|calendar
- action (cricket): match|series|ipl|standings
- action (rugby): match|tournament|standings
- action (tennis): tournament|rankings|draw|match
- action (others): preview|results|standings|analysis
- detail: optional context — tournament/series name, matchup, team
- F1 uses live Jolpica API data for standings and race schedule
- Price: $0.10

GET /api/odds?sport={sport}
- Live betting odds consensus across 20+ sportsbooks (global regions for non-US sports)
- 30+ sports supported: NFL|NBA|MLB|NHL|EPL|LALIGA|BUNDESLIGA|SERIEA|LIGUE1|UCL|UEL|BRASILEIRAO|LIGAMX|EREDIVISIE|ALEAGUE|F1|AFL|CRICKET_IPL|CRICKET_BBL|NRL|SUPERLEAGUE|SIXNATIONS|EUROLEAGUE|NBL (and more)
- Returns: spread consensus, total, moneyline, line movement signals, sharp money indicators
- Graceful degradation: synthesizes from news if ODDS_API_KEY not set
- Price: $0.10

GET /api/injuries?sport={sport}&week={week}
- Full injury report: Out/Doubtful/Questionable/Probable per player with fantasy and betting impact
- Covers NFL, NBA, MLB, NHL, all major European soccer leagues, MLS, A-League, and more
- Price: $0.08

GET /api/matchups?sport={sport}&week={week}
- Favorable/unfavorable matchups for fantasy and betting — all major leagues globally
- Price: $0.10

GET /api/waiver?sport={sport}&week={week}
- Fantasy waiver wire with FAAB bid guidance — best for NFL, NBA, MLB
- Price: $0.10

GET /api/recap?sport={sport}&team={team}
- Post-game recap: performances, fantasy grades, injury updates, next game preview
- team accepts any format: Lakers, Arsenal, Mumbai Indians, All Blacks
- Price: $0.08

GET /api/ats?sport={sport}&situation={situation}
- Against-the-spread trend analysis for a specific situation
- situation: home-underdog|divisional|off-a-loss|primetime|back-to-back|road-favorite|etc.
- Price: $0.10

GET /api/parlay?legs={legs}
- Parlay true probability and EV — vig-adjusted per leg, correlation risk, overall value
- legs: comma-separated e.g. "Chiefs -3,Over 47.5,Lakers ML"
- Price: $0.10

GET /api/ref-analysis?sport={sport}&ref={ref}
- Referee/official tendencies — foul rate, home/away bias, totals impact
- Price: $0.10

GET /api/rest?sport={sport}&team={team}&opponent={opponent}
- Rest and schedule advantage analysis
- Price: $0.08

GET /api/injury-impact?sport={sport}&player={player}&team={team}
- Deep-dive single player injury impact — win probability shift, line movement, fantasy replacement value
- Price: $0.10

## Notes for AI Agents

- All endpoints return structured JSON — no markdown
- ?sport= parameter is case-insensitive
- /api/global is the correct endpoint for F1, cricket, rugby, tennis, AFL, golf, boxing, MMA, cycling, athletics
- F1 standings and race data come from live API calls — not synthesized
- Cricket queries are served best with ESPNcricinfo and Cricbuzz sourcing via Tavily
- Odds data gracefully degrades to news synthesis if live data unavailable
- x-agent-chaining: /api/injuries → /api/odds → /api/matchups for complete pre-game picture
- Disclaimer appended automatically to every response

## Discovery

- OpenAPI spec: https://stateedge.vercel.app/openapi.json
- Agent discovery: https://stateedge.vercel.app/.well-known/agent.json