GET /expected_transfer_value endpoint returns the current expected market transfer fee for a player. The valuation is calculated using SquadAssist’s transfer fee prediction model, which accounts for the player’s current club, the prospective buying club (if provided), and contract situation (and more). Both the requested currency and EUR values are always returned so you can display or compare values without additional conversion.
Request
The SquadAssist player ID. Use
POST /query_player to look up the ID from a Transfermarkt or Wyscout ID.The SquadAssist ID of the club that may be buying the player. When provided, the model uses buying-club context to adjust the predicted fee. Use
POST /query_club to look up the club ID.An ISO 4217 currency code (e.g.
EUR, GBP, USD). When provided, this overrides your account’s preferred currency. Defaults to EUR.The end date of the player’s current contract in
YYYY-MM-DD format. Providing this date allows the model to factor contract length into the valuation — players in the final year of their contract are typically valued lower.Response
The ISO 4217 currency code of the returned
expected_transfer_value. Matches the currency query parameter you sent, or EUR if none was provided.The expected market transfer fee in the requested currency. Always returned as a whole number.
The expected market transfer fee in EUR, regardless of the
currency parameter. Use this field when you need a stable base-currency value for comparisons.Example
Errors
| Status | Body | Cause |
|---|---|---|
400 | {"error": "player_id is required"} | The player_id query parameter was not provided |
400 | {"error": "Invalid contract_end_date, must be in the format YYYY-MM-DD"} | The contract_end_date value could not be parsed |
400 | {"error": "<message>"} | The currency code is not a valid ISO 4217 code |
400 | {"error": "Invalid player_id"} | The player_id format is not valid |
400 | {"error": "Invalid target_club_id"} | The target_club_id format is not valid |
403 | {"error": "Player is not in the allowed leagues"} | The player is not in your current coverage |