Overview

Returns player market values for a football competition, optionally scoped to a particular season. Use this endpoint to retrieve the competition’s ranked market-value entries, including each player’s valuation, position, portrait/profile links, and current club.

Inputs

id (string, optional in the endpoint definition): Competition identifier placed in the URL path. Example: GB1 for the Premier League. The request URL contains an ##id## placeholder, so callers should provide a competition identifier.
saison_id (string, optional query parameter): Season identifier used to select the competition season. Example: 2024.

Response

The successful final response is a JSON object with:

data (array): Market-value entries. Each entry contains:
marketvalue (object): Valuation details, including currency, numeral, and value.
player (object): Player identity and profile data, including name, nameShort, position, detailPosition, id, portrait, and url.
team (object): Current club data, including name, icon, id, and url.
url (string|null): Entry-specific URL when available.
success (boolean): Indicates whether the request was processed successfully.

The verified response contained five entries; the example below is shortened to the first three. Market values are returned as strings and use the accompanying currency and numeral fields—for example, "220.00" with "€" and "mil." represents €220.00 million.

Auth & browser

Authentication is not required by the endpoint configuration. The request is a GET and does not require browser context according to the endpoint definition.

Examples

Request inputs:

{
  "id": "GB1",
  "saison_id": "2024"
}

Verified final response (trimmed):

{
  "data": [
    {
      "marketvalue": {
        "currency": "€",
        "numeral": "mil.",
        "value": "220.00"
      },
      "player": {
        "name": "Erling Haaland",
        "nameShort": "E. Haaland",
        "position": "Attack",
        "detailPosition": "Centre-Forward",
        "id": "418560",
        "portrait": "https://img.a.transfermarkt.technology/portrait/header/418560-1788115885.jpg?lm=4711",
        "url": "/erling-haaland/profil/spieler/418560"
      },
      "team": {
        "name": "Man City",
        "icon": "https://img.a.transfermarkt.technology/wappen/homepageWappen70x70/281.png?lm=1789459183",
        "id": "281",
        "url": "/manchester-city/startseite/verein/281"
      },
      "url": null
    },
    {
      "marketvalue": {
        "currency": "€",
        "numeral": "mil.",
        "value": "120.00"
      },
      "player": {
        "name": "Declan Rice",
        "nameShort": "D. Rice",
        "position": "Midfield",
        "detailPosition": "Central Midfield",
        "id": "357662",
        "portrait": "https://img.a.transfermarkt.technology/portrait/header/357662-1687962936.jpg?lm=4711",
        "url": "/declan-rice/profil/spieler/357662"
      },
      "team": {
        "name": "Arsenal",
        "icon": "https://img.a.transfermarkt.technology/wappen/homepageWappen70x70/11.png?lm=1789459167",
        "id": "11",
        "url": "/fc-arsenal/startseite/verein/11"
      },
      "url": null
    },
    {
      "marketvalue": {
        "currency": "€",
        "numeral": "mil.",
        "value": "110.00"
      },
      "player": {
        "name": "Morgan Rogers",
        "nameShort": "M. Rogers",
        "position": "Midfield",
        "detailPosition": "Attacking Midfield",
        "id": "503743",
        "portrait": "https://img.a.transfermarkt.technology/portrait/header/503743-1706786450.jpg?lm=4711",
        "url": "/morgan-rogers/profil/spieler/503743"
      },
      "team": {
        "name": "Chelsea",
        "icon": "https://img.a.transfermarkt.technology/wappen/homepageWappen70x70/631.png?lm=4711",
        "id": "631",
        "url": "/fc-chelsea/startseite/verein/631"
      },
      "url": null
    }
  ],
  "success": true
}

Notes

The verified upstream response was a JSON array of market-value records. The response may contain more records than shown in the example. Profile, club, portrait, and icon URLs may be relative or absolute depending on the returned field.