ratings

ELO trajectory for a season

Returns the ELO trajectory written by each ratings-pipeline run. NBA, EuroLeague and football give one point per team per matchday, ordered by date; tennis and wta give one point per player per match (a per-match Elo log), ordered by player then date. Trajectories are season-scoped; rating_basis in the response tells you how to read them — "season_relative" (top-flight football, EuroLeague) and "absolute" (NBA) both re-seed at 1500 each season (the NBA label refers to its fixed 1500-anchored scale, not to cross-season carryover), while second-division football seeds each season from the previous one regressed toward the mean ("carryover"). Tennis and wta are "points_seeded": season-scoped Elo re-seeded from tour entry points every January — never compare across seasons. Football history is league-scoped: the league parameter is required. Filter with team (substring of the team name; for tennis and wta this is the player-name filter and is strongly recommended, since a whole season is thousands of per-match rows; EuroLeague also accepts the club code) and from/to dates; page with limit/offset and has_more. The ratings dataset is published under CC BY 4.0 — reuse is welcome with a link to predixsport.com.

get/v1/ratings/{sport}/history

Request

  • Base URL: https://api.predixsport.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.predixsport.com/v1/ratings/{sport}/history
  • Auth: none declared

Path parameters

sport'nba' | 'euroleague' | 'football' | 'tennis' | 'wta' | 'champions' required

Query parameters

seasonstring nullable

Season as stored in the AI pipeline ("2026" for NBA/tennis/wta, "2025_2026" for football, "E2025" for EuroLeague). Defaults to the most recent on file.

league'serie_a' | 'premier_league' | 'la_liga' | 'bundesliga' | 'ligue_1' | 'championship' | 'league_one' | 'league_two' | 'segunda_division' | 'ligue_2' | 'bundesliga_2' | 'serie_b'

Required for football (history is league-scoped); ignored otherwise.

teamstring nullable

Filter to teams whose name contains this text (EuroLeague also matches the exact club code, e.g. 'MAD'). For tennis and wta this is the player-name filter — strongly recommended, as a whole season is thousands of per-match rows.

fromstring date nullable

Earliest matchday (YYYY-MM-DD), inclusive.

tostring date nullable

Latest matchday (YYYY-MM-DD), inclusive.

limitinteger

Points per page (a league season is ~800 points, an NBA season ~2,500).

offsetinteger

Headers

authorizationstring nullable

Response

Successful Response

OR
OR
OR
OR

Changes

No recorded changes to this operation across all 1 revision of this API.