Developers · API

Query BallSignal’s full World Cup 2026 dataset programmatically over a typed REST API.

Interactive API reference

BallSignal exposes its full dataset over a typed REST API (OpenAPI 3). The interactive reference — with every schema, parameter and a try-it console — is generated live from the server.

Open API reference → /api/docs

Authentication

Requests are authenticated with your BallSignal session (cookie-based, via the /api/auth endpoints). Send requests with credentials included; premium-gated fields require an active subscription.

# Example — fetch all qualified teams
curl -s https://ballsignal.com/api/football/teams \
  -H "Cookie: better-auth.session_token=<your-session>"

Endpoints

GET/api/football/dashboardTournament dashboard summary
GET/api/football/teamsAll qualified nations with stats
GET/api/football/teams/{key}Team detail: ELO history, squad, form
GET/api/football/groupsGroup standings & analytics
GET/api/football/matchesAll fixtures
GET/api/football/matches/{key}Match detail + ML prediction
GET/api/football/insightsModel explainability + dataset analytics
GET/api/football/match-simulationMonte Carlo scoreline simulation
GET/api/football/strategy-benchmarkBacktested Elo-signal performance
GET/api/football/model-validationCalibration vs 49k real results
GET/api/football/players/searchSearch the full player database
GET/api/football/players/{id}/profilePlayer profile, value & injuries
GET/api/football/newsLive + archived tournament news
GET/api/football/sports-stocksLive football-related equities