Pay-per-call football/soccer data API (standings, matches, teams) via x402 micropayments
What it does
Goal402 is a pay-per-call football (soccer) data API built on the x402 micropayment protocol. It provides structured data for leagues, teams, matches, and players across multiple competitions. The specific endpoint `/leagues/bae/standings` returns league standings for the league identified by "bae", including team positions, points, wins, draws, losses, goals scored/conceded, goal difference, and recent form trends.
The API covers a broad set of football data endpoints: league listings and details, league standings and match schedules, team rosters with player metadata (age, height, position, etc.), live and upcoming match feeds, full match detail with events/stats/lineups, head-to-head records, and match predictions with odds. Pricing is tiered: league and match list endpoints cost $0.001 per call, while team and individual match detail endpoints cost $0.01 per call. Payments settle on Base (EIP-155:8453) or Solana via the x402 protocol facilitated by x402.dexter.cash.
The API is self-describing — the root endpoint returns a full manifest of all available endpoints, their prices, and response schemas. Free endpoints include health checks, league listings, an LLMs.txt file for machine-readable documentation, and the x402 discovery manifest. No API key or registration is required; access is gated purely by x402 micropayment challenges.
Capabilities
Use cases
- —Retrieve current league standings for display in a sports dashboard or chatbot
- —Fetch live match scores and events for real-time notifications
- —Look up team rosters and player details for fantasy football apps
- —Get head-to-head records and predictions before a match
- —Build an AI agent that answers football trivia or provides match previews
Fit
Best for
- —AI agents needing structured football data without API key signup
- —Micropayment-native applications that pay per query
- —Developers building sports bots, dashboards, or notification systems
Not for
- —Historical multi-season statistical analysis (API appears focused on current data)
- —Non-football sports data
- —Bulk data export or full-database downloads
Quick start
curl -i https://goal402-x402.percha.workers.dev/leagues/bae/standings
# Returns 402 with x402 payment challenge.
# After paying $0.001 via x402, you receive the standings JSON.Example
Response
{
"league_id": "bae",
"standings": {
"Overall": {
"Group A": [
{
"won": 14,
"lost": 3,
"team": {
"id": "abc123",
"name": "Example FC",
"short_name": "EFC"
},
"drawn": 3,
"trend": "WWDWL",
"played": 20,
"points": 45,
"position": 1,
"goal_diff": 25,
"goals_for": 40,
"goals_against": 15
}
]
}
}
}Endpoint
Quality
The root endpoint provides a comprehensive self-describing manifest with all endpoints, pricing, and response schemas, and the x402 402 challenge confirms the endpoint is live. However, there is no formal OpenAPI spec, no worked examples with real data, and the /docs path returns 404. Score reflects good schema coverage but thin external documentation.
Warnings
- —No formal OpenAPI specification available
- —No dedicated documentation page (/docs returns 404)
- —Response schema is inferred from the root manifest; actual responses may vary
- —League ID 'bae' is not described in the manifest — the specific league it maps to is unknown
Citations
- —Goal402 is a pay-per-call football data API powered by x402 with version 1.1.0https://goal402-x402.percha.workers.dev
- —League standings endpoint costs $0.001 per callhttps://goal402-x402.percha.workers.dev
- —Payments settle on Base (eip155:8453) or Solana via facilitator x402.dexter.cashhttps://goal402-x402.percha.workers.dev
- —Team detail endpoints cost $0.01 per callhttps://goal402-x402.percha.workers.dev
- —The endpoint returned HTTP 402 confirming it is live via x402 protocolhttps://goal402-x402.percha.workers.dev/leagues/bae/standings