API-Sports
for LuumenAI
Query sports fixtures, standings, and player stats from your terminal
Ask for a league table, a fixture list, or a player's box score and get the answer in the terminal. API-Sports covers competitions across football codes, basketball, baseball, and Formula 1, with seasons going back years. Luumen connects with an API key and reads only — tools like API_SPORTS_GET_BASKETBALL_STANDINGS and API_SPORTS_GET_AFL_GAMES_STATISTICS_PLAYERS return data without changing anything.
The API-Sports toolbox
70 tools, all read-only. They answer instantly, and every call is logged.
- ReadGet AFL GamesRetrieve AFL games and matches.
- ReadGet AFL Game Player StatisticsRetrieve player statistics from AFL (Australian Football League) game(s).
- ReadGet AFL SeasonsGet the list of available seasons for AFL.
- ReadGet AFL StandingsRetrieve AFL standings for a league.
- ReadGet Baseball Games Head-to-HeadGet head-to-head baseball games between two teams.
- ReadGet Basketball BetsGet all available basketball bet types.
- ReadGet Basketball BookmakersGet all available basketball bookmakers.
- ReadGet Basketball GamesRetrieve Basketball games for a league and season, optionally by team.
- ReadGet Basketball Game Player StatisticsRetrieve player-level performance statistics for a Basketball game.
- ReadGet Basketball StandingsRetrieve ranked Basketball teams for a league season.
- ReadGet basketball statisticsGet basketball statistics for a team in a given league and season.
- ReadGet Formula 1 CircuitsGet the list of available Formula 1 circuits.
- ReadGet CoachesFetch coaches and their career history.
- ReadGet CountriesFetch available countries for league queries.
- ReadGet Fighters RecordsGet fighter career statistics.
- ReadGet FixturesRetrieve football fixtures/matches.
- ReadGet fixtures eventsGet events (goals, cards, substitutions, VAR, etc.) from a fixture.
- ReadGet Head-to-Head FixturesGet head-to-head fixtures between two teams.
- ReadGet Fixture LineupsRetrieve starting XI and substitutes for a fixture.
- ReadGet fixtures playersGet player statistics from a fixture.
- ReadGet Fixtures RoundsGet the rounds for a league or cup.
- ReadGet fixture statisticsGet statistics for a fixture.
- ReadGet Formula 1 CompetitionsRetrieve Formula 1 competitions (Grand Prix races).
- ReadGet Formula 1 RacesRetrieve Formula 1 race information for a given season.
- ReadGet Formula 1 Starting GridRetrieve the starting grid for a Formula 1 race.
- ReadGet games eventsGet events (goals, penalties, etc.) from a game.
- ReadGet AFL Games QuartersRetrieve AFL game quarter scores.
- ReadGet game statistics by teamsGet team statistics from a game by ID.
- ReadGet InjuriesGet injured or suspended players.
- ReadGet LeaguesRetrieve leagues and cups.
- ReadGet League SeasonsGet the list of available seasons for all leagues.
- ReadGet MMA CategoriesFetch the list of all available MMA categories.
- ReadGet MMA FightersFetch MMA fighters data.
- ReadGet MMA FightsRetrieve the list of MMA fights according to given parameters.
- ReadGet MMA Fight ResultsRetrieve results from one or several MMA fights.
- ReadGet MMA Fighter StatisticsGet fighter statistics from MMA fights.
- ReadGet NBA game statisticsGet NBA game statistics including player stats for both teams.
- ReadGet NFL Standings ConferencesRetrieve the list of available conferences for the NFL to be used in the standings endpoint.
- ReadGet OddsFetch pre-match odds.
- ReadGet Odds BetsGet all available pre-match bet types.
- ReadGet Odds BookmakersList all available pre-match bookmakers.
- ReadGet In-Play OddsFetch in-play odds for fixtures in progress.
- ReadGet Live Odds BetsFetch all available bet types for in-play odds.
- ReadGet Odds MappingGet the list of available fixture IDs for the odds endpoint.
- ReadGet PlayersGet player statistics.
- ReadGet Players ProfilesGet the list of all available players.
- ReadGet Players SeasonsList all available seasons for player statistics.
- ReadGet Players SquadsGet player squads.
- ReadGet player statisticsGet player statistics for a specific basketball game.
- ReadGet Players TeamsGet the list of teams and seasons in which a player played during his career.
- ReadGet Players Top AssistsGet the 20 best players (top assists) for a league or cup.
- ReadGet Players Top Red CardsGet the 20 players with the most red cards for a league or cup.
- ReadGet Players Top ScorersGet the 20 best players (top scorers) for a league or cup.
- ReadGet Players Top Yellow CardsGet the 20 players with the most yellow cards for a league or cup.
- ReadGet PredictionsGet predictions about a fixture.
- ReadGet Formula 1 Driver RankingsRetrieve Formula 1 driver rankings for a season.
- ReadGet Fastest Laps RankingsGet the ranking of the fastest laps for a Formula 1 race.
- ReadGet Race RankingsRetrieve rankings for a specific Formula 1 race.
- ReadGet Formula 1 Team RankingsRetrieve Formula 1 team rankings for a specific season.
- ReadGet SidelinedGet sidelined information (injuries, suspensions, etc.).
- ReadGet Standings DivisionsRetrieve the list of available divisions for an NFL competition to be used in the standings endpoint.
- ReadGet Standings GroupsRetrieve the list of available groups for a league to be used in the standings endpoint.
- ReadGet Standings StagesRetrieve the list of available stages for a league to be used in the standings endpoint.
- ReadGet TeamsRetrieve available teams.
- ReadGet Team SeasonsGet the list of seasons available for a team.
- ReadGet team statisticsGet detailed statistics of a team for a given league and season.
- ReadGet TimezoneFetch the complete list of available timezones for fixture queries.
- ReadGet TransfersGet all available transfers for players and teams.
- ReadGet TrophiesGet trophies for a player or coach.
- ReadGet VenuesRetrieve available venues.
Questions
How does LuumenAI connect to API-Sports?
Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Can LuumenAI change things in API-Sports on its own?
No. Every one of the 70 tools LuumenAI has for API-Sports is read-only, so it can answer questions from API-Sports but cannot change anything in it. Reads are not gated — they answer immediately, and each one is recorded on the audit trail with the actor and the result.
Who gets access to the integration?
You decide. Access is granted per agent, skill, and team, and per environment — production is not staging.
Is there an audit trail?
Every call to API-Sports is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Often connected alongside
All integrations
GitHubRepos, actions, and runbook code as context and as actions.
GitLabMerge requests and pipelines proposed, triggered, and rolled back.
BitbucketRead commits, diffs, and branches in Bitbucket, then open the fix as a held write.
Azure DevOpsAzure DevOps repos and pipelines as context — and as approved actions.Put API-Sports to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.