← Back to marketplace

OneFootball

Fast JSON API for OneFootball data - live scores, fixtures, results, match events, lineups, statistics, competitions, teams, players, transfers and search.

other
by Mark829 endpoints100% uptime293ms avg

Includes 100 free calls per month

After the free quota, standard per-request pricing applies via x402 (USDC on Base).

Endpoints

GET/v1/competition/details
$0.0010/req

Returns details for a competition.

GET/v1/competition/fixtures
$0.0010/req

Returns the fixtures for a competition.

GET/v1/competition/knockout-tree
$0.0010/req

Returns the knockout bracket (stages with matches) for a competition.

GET/v1/competition/letters
$0.0010/req

Returns the alphabetical index of all competitions.

GET/v1/competition/list
$0.0010/req

Returns all competitions for a letter.

GET/v1/competition/results
$0.0010/req

Returns the results for a competition.

GET/v1/competition/table
$0.0010/req

Returns the standings table for a competition. Supports single tables and multi-group tables.

GET/v1/competition/transfers
$0.0010/req

Returns the transfers for a competition.

GET/v1/match/details
$0.0010/req

Returns details for a match.

GET/v1/match/events
$0.0010/req

Returns the events (goals, cards, substitutions) for a match.

GET/v1/match/form-guide
$0.0010/req

Returns the recent form of both teams in a match.

GET/v1/match/lineup
$0.0010/req

Returns the line-ups for a match.

GET/v1/match/list
$0.0010/req

Returns the matches for a date, grouped by competition. Defaults to today.

GET/v1/match/live
$0.0010/req

Returns the currently live matches, grouped by competition.

GET/v1/match/prediction
$0.0010/req

Returns the fan prediction (votes) for a match.

GET/v1/match/stats
$0.0010/req

Returns the statistics for a match.

GET/v1/player/details
$0.0010/req

Returns details for a player.

GET/v1/player/seasons
$0.0010/req

Returns the seasons/competitions a player has stats for.

GET/v1/player/stats
$0.0010/req

Returns a player stats for a season, grouped by category.

GET/v1/search
$0.0010/req

Searches teams, competitions, players and news.

GET/v1/team/competitions
$0.0010/req

Returns the competitions a team takes part in.

GET/v1/team/details
$0.0010/req

Returns details for a team.

GET/v1/team/fixtures
$0.0010/req

Returns the upcoming fixtures for a team, grouped by month.

GET/v1/team/letters
$0.0010/req

Returns the alphabetical index of all teams.

GET/v1/team/list
$0.0010/req

Returns all teams for a letter.

GET/v1/team/results
$0.0010/req

Returns the past results for a team, grouped by month.

GET/v1/team/squad
$0.0010/req

Returns the squad of a team, grouped by position.

GET/v1/team/transfers
$0.0010/req

Returns the transfers for a team.

GET/v1/transfer/details
$0.0010/req

Returns the details for a transfer.

Quick start

Easiest way: the APIHub CLI. Credits cover x402, no wallet needed.

# install and set up once
npx @apihubio/cli register
npx @apihubio/cli topup 10

# call this service
npx @apihubio/cli call -X GET "https://proxy.apihub.io/onefootball/v1/competition/details?competition_id=10"

Or call the proxy directly (curl / any HTTP client):

curl https://proxy.apihub.io/onefootball/v1/competition/details?competition_id=10 \
  -H "Authorization: Bearer ahk_your_key"

# If credits available: charged automatically, returns 200
# Otherwise: returns 402 (pay via @x402/fetch or top up credits)

Pricing calculator

Estimate your monthly cost for OneFootball.

GET /v1/competition/details$0.0010/req
-
GET /v1/competition/fixtures$0.0010/req
-
GET /v1/competition/knockout-tree$0.0010/req
-
GET /v1/competition/letters$0.0010/req
-
GET /v1/competition/list$0.0010/req
-
GET /v1/competition/results$0.0010/req
-
GET /v1/competition/table$0.0010/req
-
GET /v1/competition/transfers$0.0010/req
-
GET /v1/match/details$0.0010/req
-
GET /v1/match/events$0.0010/req
-
GET /v1/match/form-guide$0.0010/req
-
GET /v1/match/lineup$0.0010/req
-
GET /v1/match/list$0.0010/req
-
GET /v1/match/live$0.0010/req
-
GET /v1/match/prediction$0.0010/req
-
GET /v1/match/stats$0.0010/req
-
GET /v1/player/details$0.0010/req
-
GET /v1/player/seasons$0.0010/req
-
GET /v1/player/stats$0.0010/req
-
GET /v1/search$0.0010/req
-
GET /v1/team/competitions$0.0010/req
-
GET /v1/team/details$0.0010/req
-
GET /v1/team/fixtures$0.0010/req
-
GET /v1/team/letters$0.0010/req
-
GET /v1/team/list$0.0010/req
-
GET /v1/team/results$0.0010/req
-
GET /v1/team/squad$0.0010/req
-
GET /v1/team/transfers$0.0010/req
-
GET /v1/transfer/details$0.0010/req
-