Pay-per-call football/soccer data API: live scores, standings, rosters, and match details via x402.
What it does
Goal402 is a pay-per-call football (soccer) data API built on the x402 micropayment protocol. It provides structured JSON data covering leagues, teams, matches, standings, player rosters, head-to-head records, and match predictions/odds. The API is hosted on Cloudflare Workers and settles payments on Base (EVM) and Solana networks through the x402 facilitator at dexter.cash.
The endpoint catalog is organized into three domains: leagues (list, detail, standings, matches by league), teams (detail, players/staff roster, matches by team), and matches (live scores, today's schedule, full match detail with events/stats/lineups, predictions, and head-to-head). Pricing ranges from $0.001 per call for lightweight queries like league listings, live matches, today's schedule, predictions, and H2H, up to $0.01 for richer payloads such as full match detail (with events, statistics, and lineups), team detail, and team rosters.
The specific endpoint `/matches/today` returns today's match schedule across all tracked leagues. Each match object includes league info, home/away teams, scores, status, winner indicator, game time, start time (ISO 8601), round, and stadium. Several free endpoints are also available including a health check, league list, and an LLMs.txt file for machine-readable documentation. Payments are accepted via USDC or equivalent stablecoins on Base (chain ID 8453) and Solana mainnet.
Capabilities
Use cases
- —Building a sports dashboard that shows today's football matches and live scores
- —AI agents that answer real-time football questions by purchasing data on demand
- —Automated betting or fantasy football tools that pull match predictions and H2H stats
- —Mobile apps displaying league standings and team rosters without monthly subscriptions
- —Data pipelines that collect match events, lineups, and statistics per game
Fit
Best for
- —Developers who want football data without subscription commitments
- —AI agents needing structured, on-demand sports data via micropayments
- —Low-volume or bursty access patterns where pay-per-call is cheaper than a flat-rate plan
- —Applications that need live match scores and today's schedule in real time
Not for
- —High-volume bulk data ingestion where a flat-rate sports data provider would be cheaper
- —Historical match data spanning multiple seasons (API appears focused on current/recent data)
- —Non-football sports data
Quick start
# Fetch today's football matches (requires x402-compatible client)
curl -i https://goal402-x402.percha.workers.dev/matches/today
# Returns 402 with x402 payment challenge; pay via Base or Solana to receive dataExample
Response
{
"matches": [
{
"id": "abc123",
"round": "Round 21",
"league": {
"id": "eng.1",
"name": "Premier League"
},
"status": "upcoming",
"winner": "none",
"stadium": "Emirates Stadium",
"away_team": {
"id": "t2",
"name": "Chelsea",
"short_name": "CHE"
},
"game_time": null,
"home_team": {
"id": "t1",
"name": "Arsenal",
"short_name": "ARS"
},
"away_score": 0,
"home_score": 0,
"start_time_utc": "2025-01-15T15:00:00Z"
}
]
}Endpoint
Quality
The root endpoint provides a comprehensive self-describing manifest with full endpoint catalog, pricing, and response schemas. The x402 challenge is confirmed live (402 returned). However, there is no formal OpenAPI spec, no separate docs page, and the exact x402 challenge body was empty in the probe, so payment token details are inferred from the manifest.
Warnings
- —x402 challenge body was empty in probe — payment parameters (token, amount, network) not directly confirmed for this specific endpoint
- —No OpenAPI or formal schema document; all schema info comes from the self-describing root JSON manifest
- —Exact stablecoin token (USDC vs other) not explicitly stated in manifest; inferred from standard x402 conventions
Citations
- —Goal402 is described as a pay-per-call football data API powered by x402 with version 1.1.0https://goal402-x402.percha.workers.dev
- —GET /matches/today costs $0.001 and returns today's match schedulehttps://goal402-x402.percha.workers.dev
- —Payments settle on Base (eip155:8453) and Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)https://goal402-x402.percha.workers.dev
- —Facilitator is https://x402.dexter.cashhttps://goal402-x402.percha.workers.dev
- —Free endpoints include /, /health, /leagues, /llms.txt, and /.well-known/x402https://goal402-x402.percha.workers.dev
- —Full match detail endpoint includes events, statistics, and lineups at $0.01 per callhttps://goal402-x402.percha.workers.dev