FootVal

A club's squad with every player's FootVal value, market value and the gap between them, plus the squad totals (value, market value, average age). Accepts a club id or name.

get_club

Side-by-side comparison of 2–4 players: FootVal value vs market value, age, position, performance percentile, every valuation factor and last-season output. Accepts ids or names.

compare_players

Scout players by attributes: league, club, national team, position, age range, preferred foot and value range, sorted by FootVal value, market value, mispricing (undervalued/overvalued), youth, performance percentile or recent rise. Returns each player's FootVal value next to the market value.

find_players

One league's clubs ranked by FootVal squad value (with the market's figure and the gap), plus its most valuable players. For the live points table use get_standings.

get_league

The live points table of a league or competition (played, won, drawn, lost, goals, goal difference, points, recent form and qualification/relegation zones). Current season by default.

get_standings

Every league FootVal values (the European first divisions plus MLS and the Saudi Pro League): strength tier, clubs, players and total squad value by FootVal and by the market. Use the returned codes with get_league, get_standings, find_players and get_rankings.

list_leagues

One match in detail: score and status, the event timeline (goals, cards, substitutions, VAR), team statistics (possession, shots, xG when available…) and line-ups with player ratings. Take match ids from get_matches or get_team_fixtures.

get_match

FootVal's daily match predictions. Every morning, before the first kick-off, FootVal's statistical model locks in the day's 10 most confident calls across the leagues it follows (match result, double chance, total goals or both teams to score) and marks each right or wrong after the final whistle. Returns one prediction day — the model's probability for each call, its likeliest score and scorers, the live or final score — plus the model's hit rate over the last 7 and 30 days. Only those 10 calls are published, not a prediction for every match. Model probabilities, not odds.

get_predictions

The strongest squad FootVal can assemble for a national team (3 GK, 8 DF, 8 MF, 7 FW — top players by value among those who represent the nation), with squad value and average age. Accepts an ISO-3 code or an English country name.

get_national_team

Ranked player lists from FootVal's valuations: top_value (most valuable), undervalued / overvalued (biggest gap between our value and the market value, players worth €10M+), risers / fallers (largest recent value moves) and wonderkids (21 and under). Optional filters: league, national team, position group, maximum age.

get_rankings