Pay-per-call football/soccer data API (leagues, teams, matches, live scores) via x402 micropayments.
What it does
Goal402 is a pay-per-call football (soccer) data API built on the x402 protocol. It provides structured data covering leagues, teams, matches, live scores, standings, player rosters, match events, statistics, lineups, predictions, odds, and head-to-head records. Payments are settled in crypto on Base (EVM) or Solana, facilitated through x402.dexter.cash.
The specific endpoint `/teams/iia/matches` returns matches for the team identified by the slug or ID "iia". It supports query parameters for filtering by match status (live, finished, upcoming), pagination via limit (max 100) and offset, and returns match objects including league info, home/away teams, scores, winner, start time, round, and stadium. The price for team-level match endpoints is $0.01 per call.
The broader API offers free endpoints (API info, health check, league listing, LLMs.txt, x402 discovery manifest) and paid endpoints ranging from $0.001 for league-level and aggregate match queries to $0.01 for team-specific and individual match detail endpoints. Response schemas are well-documented in the root manifest, covering detailed match events (goals, cards, substitutions, VAR decisions), full lineups with pitch coordinates, match statistics, and betting predictions/odds.
Capabilities
Use cases
- —Building a sports dashboard that displays live football scores and match events
- —AI agents that answer questions about football leagues, teams, and upcoming fixtures
- —Automated betting analysis using predictions, odds, and head-to-head records
- —Mobile apps showing real-time match lineups, statistics, and substitutions
- —Data pipelines aggregating football league standings and match results
Fit
Best for
- —Developers needing structured football/soccer data without subscription commitments
- —AI agents that need on-demand sports data with per-call pricing
- —Applications requiring live match scores, events, and lineups
- —Low-volume or bursty access patterns where pay-per-call is more economical than a subscription
Not for
- —Non-football sports data (basketball, baseball, cricket, etc.)
- —High-volume bulk data exports where a flat-rate subscription would be cheaper
- —Users without crypto wallets on Base or Solana
Quick start
curl -i https://goal402-x402.percha.workers.dev/teams/iia/matches?status=finished&limit=5
# Returns 402 with x402 payment challenge.
# After paying $0.01 via x402 (Base or Solana), you receive the match data.Example
Response
{
"matches": [
{
"id": "abc123",
"round": "Round 20",
"league": {
"id": "serie-a",
"name": "Serie A"
},
"status": "finished",
"winner": "home",
"stadium": "San Siro",
"away_team": {
"id": "xyz789",
"name": "AC Milan",
"short_name": "MIL"
},
"home_team": {
"id": "iia",
"name": "Inter",
"short_name": "INT"
},
"away_score": 1,
"home_score": 2,
"start_time_utc": "2025-01-15T20:45:00Z"
}
],
"team_id": "iia"
}Endpoint
Quality
The root manifest provides comprehensive endpoint documentation including response schemas, pricing, wallet addresses, and supported networks. The x402 challenge was confirmed live (402 returned). However, there is no formal OpenAPI spec, no worked request/response examples from actual calls, and the /docs path returns 404. The example response is inferred from the documented schema, not captured from a real call.
Warnings
- —No formal OpenAPI specification available; schema is inferred from the root JSON manifest.
- —The team ID 'iia' is unverified — it may not correspond to a real team in the dataset.
- —Example response is synthetic, constructed from the documented response schema, not from an actual API call.
Citations
- —Goal402 is a pay-per-call football data API powered by x402 with version 1.1.0https://goal402-x402.percha.workers.dev
- —The facilitator is https://x402.dexter.cash with wallets on Base and Solanahttps://goal402-x402.percha.workers.dev
- —GET /teams/:id/matches costs $0.01 per call and supports status, limit, and offset parametershttps://goal402-x402.percha.workers.dev
- —The API returns match objects with league, teams, scores, winner, start_time_utc, round, and stadium fieldshttps://goal402-x402.percha.workers.dev
- —Free endpoints include /, /health, /leagues, /llms.txt, and /.well-known/x402https://goal402-x402.percha.workers.dev
- —The x402 probe returned HTTP 402 confirming the endpoint is livehttps://goal402-x402.percha.workers.dev/teams/iia/matches