Get a player's game trend

Returns a day- or week-bucketed trend for one game type: legs, win rate and the game’s headline metric. Reads the daily rollup, so it stays cheap for long histories. The target must be the key owner or an accepted friend.

GET/players/{id}/trend

Authorization

x-api-keyAPI key · headerrequired

A user (dp_) or organization (dp_org_) API key with read scopes.

Path parameters

idstringrequired

The entity id.

Query parameters

gameTypestringrequired

The game type to report.

Allowed:x01cricketkillerconquesthammer-cricket

daysinteger

Days of history to include.

min 7 · max 365 · default: 90

granularitystring

Bucket size for the trend.

default: "week"

Allowed:dayweek

Responses

200

The player trend.

gameTypestringrequired

Allowed:x01cricketkillerconquesthammer-cricket

metricLabelstringrequired

granularitystringrequired

Allowed:dayweek

daysintegerrequired

min -9007199254740991 · max 9007199254740991

pointsPlayerTrendPoint[]required

Show properties

Array of PlayerTrendPoint

periodstringrequired

legsPlayedintegerrequired

min 0 · max 9007199254740991

legsWonintegerrequired

min 0 · max 9007199254740991

rankedLegsintegerrequired

min 0 · max 9007199254740991

rankedLegsWonintegerrequired

min 0 · max 9007199254740991

winRatePctnumber | nullrequired

primaryMetricnumber | nullrequired

400

Invalid request.

messagestringrequired

401

Missing or invalid API key.

messagestringrequired

403

The API key is missing a required scope or is the wrong type for this endpoint.

messagestringrequired

404

Entity not found.

messagestringrequired

429

Rate limit exceeded. See the Retry-After header.

messagestringrequired

500

Internal server error.

messagestringrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

API keyRemember on this deviceInclude my values in samples

Parameters

idpath*The entity id.gameTypequery*The game type to report.daysqueryDays of history to include.granularityqueryBucket size for the trend.

Request

curl -X GET 'https://api.dartpilot.app/v1/players/string/trend?gameType=x01' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'

const response = await fetch("https://api.dartpilot.app/v1/players/string/trend?gameType=x01", {
  method: "GET",
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://api.dartpilot.app/v1/players/string/trend?gameType=x01",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Accept": "application/json"
    },
)

Response

{
  "gameType": "x01",
  "metricLabel": "string",
  "granularity": "day",
  "days": -9007199254740991,
  "points": [
    {
      "period": "string",
      "legsPlayed": 0,
      "legsWon": 0,
      "rankedLegs": 0,
      "rankedLegsWon": 0,
      "winRatePct": 0,
      "primaryMetric": 0
    }
  ]
}

{
  "message": "string"
}

{
  "message": "string"
}

{
  "message": "string"
}

{
  "message": "string"
}

{
  "message": "string"
}

{
  "message": "string"
}