Market Value

Get Player Market Value

Retrieves the market value history and statistics for a specific player within a given league over a defined timeframe. This endpoint returns a time-series of market values along with summary statistics such as the highest/lowest market value, profit/loss, and total return points.

Path Variables

Variable	Description	Example
`leagueId`	The unique identifier of the league the player belongs to.	`{{leagueId}}`
`playerId`	The unique identifier of the player whose market value data is being requested.	`{{playerId}}`
`timeframe`	The timeframe (in days) over which to retrieve market value history.	`92`

Request Headers

Header	Value	Description
`Accept`	`application/json`	Specifies that the response should be returned in JSON format.

Response Fields

Field	Type	Description
`it`	`array`	Array of market value data points over time. Each object contains `dt` (date as an integer) and `mv` (market value at that date).
`it[].dt`	`integer`	The date of the data point, represented as a numeric value (e.g. day index).
`it[].mv`	`integer`	The player's market value on the corresponding date.
`trp`	`integer`	Total return points accumulated by the player.
`prlo`	`integer`	Profit or loss value for the player over the given timeframe.
`lmv`	`integer`	The lowest market value recorded within the timeframe.
`hmv`	`integer`	The highest market value recorded within the timeframe.
`iso`	`boolean`	Indicates whether the player is currently on sale.
`idp`	`boolean`	Indicates whether the player is in the default position (or a related status flag).
`sprmv`	`object`	Sponsor or promotional market value object, likely containing a linked promotion.
`sprmv.url`	`string`	The URL of the sponsor/promotional page.
`sprmv.lf`	`string`	Path to the sponsor's light/foreground image file.
`sprmv.durl`	`string`	Path to the sponsor's dark or alternative image file.

Example Usage

To fetch the market value history for a player over the last 92 days, set the path variables and send the request:

GET {{baseUrl}}/v4/leagues/{{leagueId}}/players/{{playerId}}/marketvalue/92
Accept: application/json

Example Response (truncated):

{
  "it": [
    { "dt": 20418, "mv": 63966965 },
    { "dt": 20419, "mv": 63980989 }
  ],
  "trp": 59842246,
  "prlo": 5759161,
  "lmv": 63966965,
  "hmv": 65601407,
  "iso": true,
  "idp": false,
  "sprmv": {
    "url": "https://go.kickbase.com/scalable",
    "lf": "content/file/f597374d...",
    "durl": "content/file/d0f8be09..."
  }
}

Note: Ensure that leagueId and playerId are set in your active environment (Kickbase v4) before sending the request. The timeframe value of 92 represents approximately the last 3 months of data.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

{ "it": [ { "dt": 20418, "mv": 63966965 ], "trp": 59842246, "prlo": 5759161, "lmv": 63966965, "hmv": 65601407, "iso": true, "idp": false, "sprmv": { "url": "https://go.kickbase.com/scalable", "lf": "content/file/f597374d71dc4ddda21c89dc4d58cf26.png", "durl": "content/file/d0f8be091ad64f668b0a6a5e12e60559.png" } }

Get Player Market Value#

Path Variables#

Request Headers#

Response Fields#

Example Usage#

Request

Responses

Get Player Market Value

Path Variables

Request Headers

Response Fields

Example Usage