Skip to main content
The POST /get_future_transfer_value endpoint predicts what a player will be worth at transfer time after a 3-year simulation period. SquadAssist finds comparable historical players — matched on attributes such as rating, potential, position, and club reputation — and projects the player’s future value based on how those peers evolved. This endpoint covers the future transfer fee component of the full ROI analysis; you can use it in isolation or as part of your own valuation pipeline. For the complete ROI picture including on-field impact, use POST /get_roi_analysis instead.
The simulation always uses the 2025/2026 season as the starting point and projects 3 years forward. Season and simulation length are not yet request parameters. Reach out in case this is of importance.

​
Request

The request body must be a JSON object.
​
player_id
string
required
The SquadAssist player ID. Use POST /query_player to look up the ID from a Transfermarkt or Wyscout ID.
​
club_id
string
required
The SquadAssist club ID for the club the player would be joining. The club’s reputation and league context influence the prediction. Use POST /query_club to look up the ID.
​
expected_transfer_value
number
The current transfer fee in the currency specified by currency_code. This serves as the baseline value for the prediction. If omitted, SquadAssist calculates an expected fee automatically.
​
currency_code
string
An ISO 4217 currency code (e.g. EUR, GBP, USD). The expected_transfer_value input is interpreted in this currency, and all monetary output values are returned in this currency alongside their EUR equivalents. Defaults to EUR.

​
Response

​
currency
string
The ISO 4217 currency code for all non-EUR monetary values in the response.
​
future_transfer_value
integer
The predicted market transfer value at the end of the 3-year simulation, in the requested currency.
​
future_transfer_value_in_eur
integer
The predicted market transfer value at the end of the 3-year simulation, in EUR.
​
value_category
string
A category summarising the predicted value trajectory. One of: "Elite Prospect", "Excellent Opportunity", "Steady Grower", "Stable Value", "Decline", or "Major decline".
​
probabilities_of_different_outcomes
object
A probability distribution across all six outcome categories, based on how comparable historical players performed.
​
explanations
object
Explanatory data about the prediction.

​
Example

curl -X POST https://api.squadassist.ai/v1/get_future_transfer_value \
  -H "x-api-key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "player_id": "P01JJ9Q8SSAA1PN94F070VGY9Q3",
    "club_id": "C01JJBVJAPKG8CM7ZA5JF5G84R8",
    "expected_transfer_value": 4000000,
    "currency_code": "EUR"
  }'

​
Errors

StatusBodyCause
400{"error": "player_id is required"}player_id was not included in the request body
400{"error": "club_id is required"}club_id was not included in the request body
400{"error": "Invalid player_id"}The player_id format is not valid
400{"error": "Invalid club_id"}The club_id format is not valid
400{"error": "currency_code must be a string"}currency_code was provided but is not a string
400{"error": "<message>"}The currency_code is not a valid ISO 4217 code
403{"error": "Player is not in the allowed leagues"}The player is not in your current coverage
403{"error": "Requested club is not allowed"}The club_id is not available on your plan
404{"error": "Club not found"}No club was found for the provided club_id