Pay-per-call football/soccer data API (teams, matches, leagues) settled via x402 on Base and Solana.
What it does
Goal402 is a pay-per-call football (soccer) data API powered by the x402 payment protocol. It provides structured data on leagues, teams, matches, players, standings, predictions, and head-to-head records. Payments are settled on-chain via Base (EVM) or Solana, facilitated through x402.dexter.cash.
The specific endpoint `/teams/:id` returns detailed team information including name, short name, country, team colors, stadium details (name, capacity, address, coordinates), founding year, nickname, and city. This endpoint costs $0.01 per call. Other team endpoints at the same price tier include team rosters (`/teams/:id/players`) and team match history (`/teams/:id/matches`). League-level and match-listing endpoints are cheaper at $0.001 per call, while detailed single-match data (events, stats, lineups) costs $0.01.
The API exposes several free endpoints including a health check, league listing, an LLMs.txt file for machine-readable documentation, and the x402 discovery manifest. The paid endpoints cover leagues (detail, standings, matches), teams (detail, players, matches), and matches (live, today's schedule, full match detail, predictions, head-to-head). All responses are JSON with well-documented schemas. The API is hosted on Cloudflare Workers and accepts payments to wallet `0x22A2e19BDBe9f3FfEf652FcbC3cdD0F67147Ef38` on Base or `FpsvkK2xpyhy759V5vXRQP4cjDmU9SdmdpSjNkYv5WJY` on Solana.
Capabilities
Use cases
- —Building a sports dashboard that displays team details, stadium info, and rosters
- —AI agent that retrieves live match scores and standings for conversational queries
- —Automated sports betting analysis using predictions and head-to-head data
- —Mobile app fetching today's match schedule and real-time scores
- —Data pipeline collecting league standings and match statistics for analytics
Fit
Best for
- —Agents or apps needing on-demand football/soccer data without subscriptions
- —Developers who want crypto-native pay-per-call pricing with no API keys
- —Low-volume or bursty access patterns where per-call pricing is cost-effective
Not for
- —High-volume bulk data ingestion where per-call costs would add up quickly
- —Historical data archives spanning multiple seasons (API appears focused on current data)
- —Non-football sports data
Quick start
curl -X GET https://goal402-x402.percha.workers.dev/teams/iia
# Returns 402 with x402 payment challenge.
# After paying via x402 ($0.01 on Base or Solana), you receive team detail JSON.Example
Response
{
"id": "iia",
"city": "London",
"name": "Example FC",
"color": "#FF0000",
"founded": "1892",
"nickname": "The Examples",
"country_id": "eng",
"short_name": "EFC",
"text_color": "#FFFFFF",
"stadium_lat": 51.5074,
"stadium_lng": -0.1278,
"stadium_name": "Example Stadium",
"stadium_address": "123 Football Lane",
"stadium_capacity": 60000
}Endpoint
Quality
The root endpoint provides a comprehensive API manifest with full endpoint listing, pricing, and response schemas. The x402 challenge is confirmed live (402 returned). No formal OpenAPI spec exists, and the example response is inferred from the documented schema rather than an actual paid response.
Warnings
- —No OpenAPI specification available; schema is inferred from the root JSON manifest
- —Example response is synthetic based on documented response shape, not an actual API response
- —Team ID 'iia' in the endpoint path is opaque; no documentation on how to discover valid team IDs beyond the leagues endpoints
Citations
- —Goal402 is a pay-per-call football data API powered by x402 with version 1.1.0https://goal402-x402.percha.workers.dev
- —The /teams/:id endpoint costs $0.01 per call and returns team detail including stadium info, colors, and founding yearhttps://goal402-x402.percha.workers.dev
- —Payments are facilitated via x402.dexter.cash on Base (eip155:8453) and Solanahttps://goal402-x402.percha.workers.dev
- —Base wallet is 0x22A2e19BDBe9f3FfEf652FcbC3cdD0F67147Ef38 and Solana wallet is FpsvkK2xpyhy759V5vXRQP4cjDmU9SdmdpSjNkYv5WJYhttps://goal402-x402.percha.workers.dev
- —The endpoint returns HTTP 402 confirming it is live via x402 protocolhttps://goal402-x402.percha.workers.dev/teams/iia