Pay-per-call football/soccer data API (leagues, teams, matches, live scores) via x402 micropayments.
What it does
Goal402 is a football (soccer) data API that serves league standings, team rosters, match details, live scores, predictions, and head-to-head records. It uses the x402 protocol for pay-per-call micropayments, settling on Base (EIP-155:8453) or Solana. The API is hosted on Cloudflare Workers and facilitated through x402.dexter.cash.
The API offers both free and paid endpoints. Free endpoints include the root discovery manifest, health check, league listing, and LLM-readable documentation. Paid endpoints cover league details and standings ($0.001/call), team details and rosters ($0.01/call), match details with full events/stats/lineups ($0.01/call), live matches and today's schedule ($0.001/call), and match predictions, odds, and head-to-head data ($0.001/call). Responses are JSON with well-documented schemas covering team info, player data, match events (goals, cards, substitutions, VAR decisions), formation lineups with pitch coordinates, and match statistics.
The GET /leagues endpoint (the cataloged endpoint) is listed as free and returns a list of all leagues with their id, name, and country_name. The probe confirmed it responds with HTTP 200 on GET, consistent with it being a free tier endpoint that does not require x402 payment. Paid endpoints require x402 negotiation and payment to the provider's Base or Solana wallet addresses.
Capabilities
Use cases
- —Building a football dashboard that pulls live scores and standings on demand
- —AI agents that answer real-time football questions with pay-per-query data access
- —Telegram or Discord bots serving match lineups, predictions, and head-to-head stats
- —Data analysis pipelines that fetch team rosters and match statistics programmatically
- —Embedding live match data into sports betting or fantasy football applications
Fit
Best for
- —Developers needing structured football/soccer data without subscription commitments
- —AI agents that need on-demand sports data with micropayment settlement
- —Applications requiring live match scores, lineups, and event-by-event detail
- —Projects on Base or Solana that want native crypto-settled API calls
Not for
- —Non-football sports data needs (this API covers only football/soccer)
- —High-volume bulk data exports where per-call pricing would be cost-prohibitive
- —Users without crypto wallets on Base or Solana (no fiat payment option documented)
Quick start
# Free endpoint — list all leagues (no payment required)
curl https://goal402-x402.percha.workers.dev/leagues
# Paid endpoint example — league standings (requires x402 payment)
# First call returns 402 with payment challenge; complete payment to access data
curl https://goal402-x402.percha.workers.dev/leagues/LEAGUE_ID/standingsExample
Response
{
"id": "eng.1",
"name": "Premier League",
"country_name": "England"
}Endpoint
Quality
The root endpoint provides a comprehensive self-describing manifest with full endpoint documentation, pricing, and response schemas. However, there is no formal OpenAPI spec, the /leagues endpoint itself is free (not gated by x402 402 challenge), and the probe did not capture an actual x402 challenge on this specific endpoint. Paid endpoint behavior is documented but not directly verified.
Warnings
- —The /leagues endpoint returned HTTP 200 (free tier), not 402 — it does not require x402 payment despite being listed under an x402 provider.
- —No OpenAPI specification is available; schema documentation comes only from the root JSON manifest.
- —No /docs, /api, /pricing, or /README pages exist — all documentation is embedded in the root response.
- —Paid endpoint x402 behavior was not directly probed; pricing and payment flow are inferred from the manifest only.
Citations
- —Goal402 is described as a pay-per-call football data API powered by x402, version 1.1.0, facilitated by x402.dexter.cashhttps://goal402-x402.percha.workers.dev
- —Free endpoints include GET /leagues which lists all leagues with id, name, and country_namehttps://goal402-x402.percha.workers.dev
- —Paid league endpoints cost $0.001 per call; team endpoints cost $0.01 per call; match detail costs $0.01 per callhttps://goal402-x402.percha.workers.dev
- —Payments settle on Base (eip155:8453) or Solana with specified wallet addresseshttps://goal402-x402.percha.workers.dev
- —GET /leagues returned HTTP 200 on probe, confirming it is a free endpointhttps://goal402-x402.percha.workers.dev/leagues