Data

Brasileirão Série A — standings, rodadas, artilheiros

Live Brasileirão Série A data from football-data.org: full standings (total + home + away splits), rodada-by-rodada match results, top scorers, team rosters. 10-season history available. Aggressive caching (15 min during live rodadas, 1h otherwise) to stay within free-tier limits. Eliminates training-data hallucinations on current standings by hitting live data per request.

Verified: 2026-05-03 (laranja-data-plane-audit-2026-05-02)

Risk Flags

  • MEDIUM operational Capability is gated on the FOOTBALL_DATA_KEY env var being set in the Lambda environment. Until registered (free at https://www.football-data.org/client/register), all calls return FootballDataNotConfiguredError. This is THE blocker for cap #9's tier migration in the laranja A/B experiment — without the key, hermesag falls back to training data and hallucinates current standings.
  • LOW supply_chain football-data.org is a third-party service. Free tier has no SLA; production workflows on this surface should plan for occasional 404s during their maintenance windows.

Cost

Type: Free · Free tier: 10 req/min on football-data.org TIER_ONE; cached aggressively to stay under cap.

Hidden costs

  • Requires FOOTBALL_DATA_KEY env var on the Lambda; until set, capability raises FootballDataNotConfiguredError.
  • Free tier rate-limits at 10 req/min; cache TTLs (15 min live / 1h otherwise) prevent burst exhaustion.

Install

Default

curl -s -H "Authorization: Bearer $AUXILIAR_TOKEN" "https://api.auxiliar.ai/api/invoke/br_futebol_brasileirao_tabela"
# Current standings (total + home + away splits):
#   GET /api/invoke/br_futebol_brasileirao_tabela?season=2026
#     → { season, matchday, standings_total: [{ position, team, points, wins, draws, losses, goal_difference }, ...] }
#
# Match results by rodada:
#   GET /api/invoke/br_futebol_brasileirao_rodada?matchday=12
#     → { matchday, matches: [{ home, away, score, status, kickoff }, ...] }
#
# Top scorers:
#   GET /api/invoke/br_futebol_brasileirao_artilheiros?season=2026
#     → ranked list of scorers with goals/assists
#
# If you see FootballDataNotConfiguredError in the response, the
# FOOTBALL_DATA_KEY env var is unset on the gateway Lambda.
# Fall back to web search until ops registers the key.

Estimated time to first success: ~5 min

Dependencies

Minimum runtime: Any HTTP client

Distribution

Repository
https://github.com/Tlalvarez/Auxiliar-ai