Ratings de jogadores

Como funciona a nota de 0 a 10 de cada jogador por partida e onde ela aparece na API.

Cada jogador com pelo menos 20 minutos em campo recebe uma nota de 0 a 10 por partida, calculada pelo nosso modelo interno a partir das estatísticas do jogo. Os ratings fazem parte dos planos ULTRA e MEGA.

Onde o rating aparece

Endpoint	Campo
GET /v1/matches/{match_id}/players	rating completo, com categorias
GET /v1/players/{player_id}/matches	rating de cada partida
GET /v1/players/{player_id}/stats	avg_rating e rated_matches na temporada
GET /v1/competitions/{competition_id}/players/stats	Ranking com sort=rating

Composição da nota

Campo	Conteúdo
rating	Nota final da partida
rating_base	Nota antes de bônus e penalidades
bonus_total	Soma dos bônus aplicados
penalty_total	Soma das penalidades aplicadas
categories	Notas de attack, defense, passing e possession
categories_relative	Cada categoria comparada com a média da liga para jogadores da mesma função
position_group	Função usada pelo modelo

{
  "rating": 6.86,
  "rating_base": 7.4135,
  "bonus_total": 0.0,
  "penalty_total": 0.55,
  "position_group": "FB",
  "categories": { "attack": 6.0, "defense": 6.56, "passing": 7.97, "possession": 8.29 },
  "categories_relative": { "attack": -1.47, "defense": -3.18, "passing": 4.63, "possession": 2.0 }
}

Como usar

• Ordene jogadores por desempenho em uma temporada com sort=rating e min_minutes para evitar amostras pequenas.
• Use categories para entender o perfil do jogador: um lateral com nota alta em passe e posse, por exemplo.
• Compare categories_relative entre jogadores da mesma função.