Pay-per-call football/soccer data API: live matches, standings, teams, and predictions via x402 micropayments.
What it does
Goal402 is a pay-per-call football (soccer) data API that uses the x402 protocol for micropayments. It provides comprehensive coverage of football leagues, teams, matches, and statistics. The API is hosted on Cloudflare Workers and settles payments on Base (EVM) and Solana networks via the Dexter.cash facilitator.
The specific endpoint `/matches/live` returns all currently live matches across all covered leagues. Each match object includes league info, home and away team names and IDs, current scores, match status, game time, start time (UTC), round, and stadium. The price is $0.001 per call. Other endpoints in the Goal402 suite cover league standings, team rosters, match details with full event timelines (goals, cards, substitutions), lineups, statistics, predictions/odds, and head-to-head records.
Pricing is tiered by data depth: league and match listing endpoints cost $0.001 per call, while detailed team and individual match endpoints cost $0.01 per call. The API accepts payments to wallet `0x22A2e19BDBe9f3FfEf652FcbC3cdD0F67147Ef38` on Base or `FpsvkK2xpyhy759V5vXRQP4cjDmU9SdmdpSjNkYv5WJY` on Solana. Free endpoints include health checks, league listing, and the x402 discovery manifest.
Capabilities
Use cases
- —Building a live football score dashboard or widget
- —AI agents that answer real-time football questions
- —Automated sports betting analysis pipelines
- —Football chatbot integrations that need current match data
- —Mobile apps displaying live match updates
Fit
Best for
- —Developers needing pay-per-call football data without subscriptions
- —AI agents that need real-time live match information
- —Low-volume or bursty access patterns where per-call pricing is economical
Not for
- —Historical football data archives spanning many seasons (no bulk historical endpoints documented)
- —Non-football sports data
- —High-frequency polling at sub-second intervals (no streaming/websocket support documented)
Quick start
curl -X GET https://goal402-x402.percha.workers.dev/matches/live
# Returns 402 with x402 payment challenge.
# Complete the payment via x402 protocol to receive live match data.Example
Response
{
"matches": [
{
"id": "abc123",
"round": "Round 21",
"league": {
"id": "eng.1",
"name": "Premier League"
},
"status": "in_progress",
"winner": "none",
"stadium": "Emirates Stadium",
"away_team": {
"id": "t200",
"name": "Chelsea",
"short_name": "CHE"
},
"game_time": 67,
"home_team": {
"id": "t100",
"name": "Arsenal",
"short_name": "ARS"
},
"away_score": 0,
"home_score": 1,
"start_time_utc": "2025-01-15T15:00:00Z"
}
]
}Endpoint
Quality
The root endpoint provides a comprehensive self-describing manifest with full response schemas, pricing, wallet addresses, and endpoint documentation. The x402 challenge is confirmed live (402 returned). No formal OpenAPI spec is available, and /docs returns 404, but the inline manifest is detailed enough to build against.
Warnings
- —No formal OpenAPI specification available; documentation is entirely from the root JSON manifest
- —The x402 challenge object returned empty ({}) during probing — actual payment parameters (amount, token, network) are not captured in the probe
- —Response examples are inferred from the documented schema, not from actual paid API responses
Citations
- —Goal402 is described as a pay-per-call football data API powered by x402, version 1.1.0https://goal402-x402.percha.workers.dev
- —GET /matches/live costs $0.001 and returns all live matcheshttps://goal402-x402.percha.workers.dev
- —Payments settle on Base (eip155:8453) or Solana via Dexter.cash facilitatorhttps://goal402-x402.percha.workers.dev
- —Team detail endpoints cost $0.01 per callhttps://goal402-x402.percha.workers.dev
- —Base wallet address is 0x22A2e19BDBe9f3FfEf652FcbC3cdD0F67147Ef38https://goal402-x402.percha.workers.dev