# FootballPulse

> Global football/soccer betting intelligence API — the world's #1 sport, now fully accessible to AI agents. Match previews, Asian handicap analysis, live in-play intelligence, value bets, accumulators, league stats, player intelligence, corner/booking markets, clean sheet probability, and transfer watch. 50+ leagues across 6 continents. Pay-per-query via x402 micropayments on Base mainnet.

## What This Is

FootballPulse is a pay-per-query API that synthesises live football data, real-time news, and structured league statistics into actionable betting intelligence. Football is the #1 globally bet-on sport — $800B+ wagered annually, 25-40% of total sports betting volume worldwide.

Every response uses Claude AI (Sonnet for complex analysis, Haiku for aggregation) with data from Football-Data.org (free structured API for top leagues) and Tavily real-time web search.

## Payment

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

- Sonnet endpoints (match-preview, value-bets, asian-handicap, live-intel, accumulator): $0.15
- Haiku endpoints (league-pulse, player-intel, corner-cards, clean-sheet, transfer-watch): $0.10

Send a GET request without PAYMENT-SIGNATURE to receive a 402 with payment requirements.

## Endpoints

### GET /api/match-preview?home={team}&away={team}&league={code}&date={YYYY-MM-DD}&lang={lang}
Pre-match intelligence: team form (last 5), H2H history, injury updates, xG comparison, key tactical battles, predicted score, primary bet. Covers any league worldwide.
Price: $0.15 | Model: claude-sonnet-4-6
Example: ?home=Arsenal&away=Chelsea&league=PL

### GET /api/value-bets?league={code}&date={YYYY-MM-DD}&market={all|btts|goals|result|handicap}&lang={lang}
EV analysis across all markets for a full matchday. Returns EV-rated selections (HIGH/MEDIUM/LOW/AVOID) with confidence levels and top value pick.
Price: $0.15 | Model: claude-sonnet-4-6
Example: ?league=PL&date=2026-06-07&market=all

### GET /api/asian-handicap?home={team}&away={team}&line={line}&league={code}&lang={lang}
Deep Asian handicap analysis — the dominant format in Asia's $200B+ betting market. Quarter-ball/half-ball line selection, Pinnacle/Macau market perspective, sharp money indicators, steam move detection.
Price: $0.15 | Model: claude-sonnet-4-6
Example: ?home=Man+City&away=Crystal+Palace&league=PL

### GET /api/live-intel?home={team}&away={team}&minute={min}&score={score}&lang={lang}
Real-time in-play intelligence: momentum indicators, xG trajectory, dangerous attacks, substitution impact, in-play market recommendations.
Price: $0.15 | Model: claude-sonnet-4-6
Example: ?home=Liverpool&away=Tottenham&minute=67&score=1-0

### GET /api/accumulator?leagues={codes}&date={date}&strategy={strategy}&max_legs={n}&lang={lang}
Evidence-based multi-match accumulator builder. Ranked selections across multiple leagues with combined odds, EV assessment, banker pick, risk rating, stake guide.
Strategy: value | safe | btts | goals | mixed
Price: $0.15 | Model: claude-sonnet-4-6
Example: ?leagues=PL,PD,BL1,SA,FL1&strategy=value&max_legs=5

### GET /api/league-pulse?league={code}&season={season}&lang={lang}
League snapshot: standings, top scorers, over/under 2.5 rate, BTTS rate, home/away split, average goals, betting angles.
League codes: PL, PD, BL1, SA, FL1, CL, EL, PPL, DED, BSA
Price: $0.10 | Model: claude-haiku-4-5
Example: ?league=PL

### GET /api/player-intel?player={name}&team={team}&league={league}&lang={lang}
Player profile: season stats, xG/xA, injury status, Transfermarkt value, FPL price/ownership, card risk, penalty taker status, transfer news.
Price: $0.10 | Model: claude-haiku-4-5
Example: ?player=Erling+Haaland&team=Manchester+City

### GET /api/corner-cards?home={team}&away={team}&referee={name}&competition={comp}&lang={lang}
Specialty markets: corner statistics (team averages, combined expected, over 9.5/10.5), booking points (referee profile, high-risk players, over 30/35 pts).
Price: $0.10 | Model: claude-haiku-4-5
Example: ?home=Arsenal&away=Chelsea&referee=Michael+Oliver

### GET /api/clean-sheet?team={team}&league={code}&home_away={home|away|both}&lang={lang}
Clean sheet probability: season CS rate, home/away split, GK stats, defensive metrics, BTTS probability, under 2.5 probability.
Price: $0.10 | Model: claude-haiku-4-5
Example: ?team=Arsenal&league=PL&home_away=home

### GET /api/transfer-watch?team={team}&player={player}&league={league}&window={window}&lang={lang}
Transfer intelligence: rumours with RELIABLE/SPECULATIVE/CLICKBAIT ratings, completed deals, squad impact, market values, deadline intel.
Price: $0.10 | Model: claude-haiku-4-5
Example: ?team=Arsenal&window=summer

## League Coverage

Top 5 European leagues (structured data): Premier League, La Liga, Bundesliga, Serie A, Ligue 1
European cups: Champions League, Europa League, Conference League
Additional (web intelligence): MLS, Liga MX, Brasileirao, Argentine Primera, Eredivisie, Primeira Liga, Super Lig, J-League, K-League, Chinese Super League, Saudi Pro League, A-League, NPFL, PSL, and 30+ more

## Language Support

en (English), es (Spanish), fr (French), de (German), pt (Portuguese), ja (Japanese), zh (Chinese), ko (Korean), ar (Arabic)

## Discovery

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

## Notes for AI Agents

- All endpoints return structured JSON
- Football-Data.org data activates automatically when FOOTBALL_DATA_API_KEY is set — degrades gracefully without it
- Tavily real-time search always active
- Disclaimer appended to every response
- Asian handicap endpoint is purpose-built for the Asian betting market — use for AH-specific queries
- Corner/cards endpoint supports booking points bets — UK standard (yellow=10pts, red=25pts)