Pay-per-call football match predictions and odds via x402 micropayments
What it does
Goal402 is a pay-per-call football (soccer) data API that settles payments via the x402 protocol. It provides comprehensive coverage of leagues, teams, matches, and predictions across global football competitions. The specific endpoint at `/matches/:id/predictions` returns prediction data and odds for a given match, including home/draw/away vote counts, total votes, and decimal odds.
The API is organized into four resource groups: leagues (listings, standings, fixtures), teams (details, rosters, schedules), matches (live scores, today's schedule, full match detail with events/stats/lineups, predictions, and head-to-head records). Pricing ranges from $0.001 per call for lightweight endpoints like predictions, live matches, and league data, up to $0.01 for richer endpoints like full match detail and team information. Payments settle on Base (EIP-155:8453) or Solana, facilitated through x402.dexter.cash.
The predictions endpoint specifically returns vote distributions (home_votes, draw_votes, away_votes, total_votes) and optional decimal odds (home_odds, draw_odds, away_odds) for any match identified by its ID. This makes it useful for building betting analysis tools, match preview generators, or AI agents that need crowd sentiment and odds data for football matches.
Capabilities
Use cases
- —Fetching crowd-sourced predictions and odds for upcoming football matches
- —Building automated match preview content with vote distributions
- —AI agents that compare odds across sources for value betting analysis
- —Integrating live football data into dashboards or chatbots
- —Generating head-to-head and prediction summaries for sports newsletters
Fit
Best for
- —AI agents needing on-demand football predictions without subscriptions
- —Developers building pay-as-you-go sports data integrations
- —Low-volume consumers who want match odds without committing to a monthly plan
Not for
- —High-volume bulk data consumers who need flat-rate pricing
- —Historical odds data archives spanning multiple seasons
- —Non-football sports data
Quick start
curl -X GET https://goal402-x402.percha.workers.dev/matches/egdcbej/predictions
# Returns 402 with x402 payment challenge.
# After settling the $0.001 payment via x402, you receive:
# {"match_id": "egdcbej", "home_votes": 120, "draw_votes": 45, "away_votes": 80, ...}Example
Response
{
"match_id": "egdcbej",
"away_odds": 4.2,
"draw_odds": 3.4,
"home_odds": 1.85,
"away_votes": 80,
"draw_votes": 45,
"home_votes": 120,
"total_votes": 245
}Endpoint
Quality
The root endpoint provides a comprehensive self-documenting manifest with full response schemas and pricing for all endpoints. However, there is no formal OpenAPI spec, the x402 challenge body was empty (no payment details captured in the probe), and there are no dedicated docs pages. The response example is inferred from the documented schema rather than observed.
Warnings
- —x402 challenge body was empty in the probe — payment parameters (amount, token, network) were not captured
- —No OpenAPI specification available
- —Response example is inferred from the documented schema, not from an actual API response
- —The match ID 'egdcbej' in the endpoint URL may be ephemeral or specific to a particular match
Citations
- —Goal402 is a pay-per-call football data API powered by x402 with version 1.1.0https://goal402-x402.percha.workers.dev
- —The /matches/:id/predictions endpoint costs $0.001 and returns vote counts and oddshttps://goal402-x402.percha.workers.dev
- —Payments settle on Base (eip155:8453) or Solana via x402.dexter.cash facilitatorhttps://goal402-x402.percha.workers.dev
- —Base wallet is 0x22A2e19BDBe9f3FfEf652FcbC3cdD0F67147Ef38, Solana wallet is FpsvkK2xpyhy759V5vXRQP4cjDmU9SdmdpSjNkYv5WJYhttps://goal402-x402.percha.workers.dev