Ranking API

Rank a selected list of teams from best to worst

The ranking will be accompanied by a normalised strength value for each team. The strength value is a number between 0 and 1, where 1 is the strongest team and 0 is a totally hopeless team with no chance of ever winning any games, i.e. 0 is a theoretical value.

To interprete the strength values, consider the following: Let's say you have a ranking with two teams, one has a strength value of 1, the second has one of 0.65. Then this means that if the first team has a chance of x % of beating a given third team, the second team has a chance of 0.65 * x % of beating the same third team.

This endpoint requires that valid Bayes team perids and date are sent with the API call:

GET - /api/ranking?team_perids={team1_perid}&team_perids={team2_perid}
      &team_perids={team3_perid} ... &team_perids={teamN_perid}
      &date={ISO_DATE}
      &min_num_datapoints={MIN_NUM_DATAPOINTS}

parameter	type	description
team_perids	array, string	List of Bayes perids for teams to be ranked
date	ISO date format	The date for a hypotheitical map where the team strengths apply. This date could be for an upcoming map or apply to a map in the past. Should be in format YYYY-MM-DD
min_num_datapoints	integer	Optional. The minimum number of valid datapoints that a team should possess to be included in the ratings list

If the date is for a map in the future the current team strengths apply, no additional extrapolation is taken.

The perids for both teams can be found in the Bayes Fixtures Services.

The JSON response from the API call is an array string of team Bayes perids that gives the ranking of teams from best to worst.

📝 Note

Please note that the sorted list only contains teams with enough datapoints to calculate an accurate ranking. Teams with too few datapoints are dropped. This setting can be overriden by using the optional parameter min_num_datapoints but this is generally not recommended.

[
  'esports:team:9bc943f6-3ac6-4a6b-9c18-577e527e5062', '1.00',
  'esports:team:cf4253cd-2ce9-4818-84f4-5fc918d7665b', '0.65'
]