Pay-per-call football/soccer data API via x402 — league details for $0.001 per request
What it does
Goal402 is a pay-per-call football (soccer) data API powered by the x402 micropayment protocol. It provides structured data covering leagues, teams, matches, standings, predictions, head-to-head records, and lineups across multiple football competitions. The specific endpoint `/leagues/cf` returns league detail for the league identified by the code "cf".
Pricing is tiered by data granularity: league-level endpoints (league detail, standings, matches, live matches, today's schedule, predictions, h2h) cost $0.001 per call, while team and detailed match endpoints cost $0.01 per call. Payments settle on Base (EIP-155:8453) or Solana via the x402 facilitator at x402.dexter.cash. The API accepts USDC on these networks to the provider's published wallet addresses.
The API exposes a comprehensive response schema for each endpoint, including match events (goals, cards, substitutions, VAR decisions), match statistics, full lineups with pitch coordinates, team rosters with player metadata, and stadium information. Free endpoints include a health check, league listing, and an LLMs.txt machine-readable documentation file. There is no OpenAPI spec published, but the root endpoint serves a detailed JSON manifest describing all endpoints, pricing, and response shapes.
Capabilities
Use cases
- —AI agents fetching real-time football match scores and events
- —Building dashboards showing league standings and team statistics
- —Retrieving head-to-head records and predictions for upcoming matches
- —Accessing team rosters and player metadata for fantasy football apps
- —Monitoring live matches across multiple leagues
Fit
Best for
- —AI agents needing on-demand football data without subscriptions
- —Low-volume or sporadic football data queries where pay-per-call is cost-effective
- —Developers building football-related tools on crypto-native payment rails
Not for
- —High-volume bulk data ingestion where flat-rate APIs are cheaper
- —Historical data archives spanning multiple seasons (no historical endpoints documented)
- —Non-football sports data
Quick start
curl -i https://goal402-x402.percha.workers.dev/leagues/cf
# Returns 402 with x402 payment challenge.
# After paying via x402 facilitator (https://x402.dexter.cash),
# you receive league detail JSON for league "cf".Example
Response
{
"id": "cf",
"name": "Example League Name",
"country_name": "Example Country"
}Endpoint
Quality
The root endpoint provides a thorough JSON manifest with all endpoints, pricing, and response schemas, but there is no formal OpenAPI spec, no crawled docs page, and the x402 challenge body was empty (no payment details captured in the probe). Response examples are inferred from the manifest's documented response shapes rather than observed.
Warnings
- —x402 challenge body was empty in the probe — payment parameters (amount, token, network) were not directly captured
- —No OpenAPI or formal schema document is published
- —The league code 'cf' is not explained in the manifest; its meaning is inferred
- —Response example is synthetic based on documented schema, not an observed response
Citations
- —Goal402 is a pay-per-call football data API powered by x402 with pricing at $0.001 for league endpoints and $0.01 for team/match detail endpointshttps://goal402-x402.percha.workers.dev
- —Payments settle on Base (eip155:8453) or Solana via the facilitator at x402.dexter.cashhttps://goal402-x402.percha.workers.dev
- —The /leagues/:id endpoint returns id, name, and country_namehttps://goal402-x402.percha.workers.dev
- —The API version is 1.1.0https://goal402-x402.percha.workers.dev