GET Goldstars
https://pd.{shard}.a.pvp.net/goldstars/v1/goldstars Get the list of all existing goldstars ("medals"), the awards shown after a match for stats such as kills, assists or headshot percentage.
The list does not depend on the player and rarely changes, so it can be cached for a long time. Riot does not return localized names or descriptions - the only name is the internal one in the obfuscated tempT field, which has also been observed under the keys displayName, name, title and devName in different client builds.
The internal names in the tempT field identify every goldstar, including the three that could previously only be guessed from the data. The meaning column below was confirmed by comparing the values of the Player Goldstars endpoint with the stats of the same matches from the Match Details endpoint:
| Goldstar ID | Internal name | Meaning |
|---|---|---|
6dc31cfd-41da-895f-9246-a8b63558cdb8 |
Damage |
Damage per round (ADR) |
2c8b6129-4384-230d-c7e5-cda12019533c |
HeadshotPercentage |
Headshot percentage of the match |
1b13755f-4d5a-2c9e-6a39-bea7e6c53e7f |
Kills |
Kills |
1c926cba-48cb-8aeb-c68d-a1ba2d012784 |
TopFrag |
Top fragger of the match; the value equals that player's kills |
e43f9acb-448c-4aa1-1591-6db72c0b8dae |
Assists |
Assists |
352a3ac8-4b2c-db6a-1f36-c0a67b428e65 |
Plants |
Spike plants |
bfe96c47-44d0-e473-585d-749146d2d05e |
FirstBlood |
First kills |
244cf4ab-4c27-cc59-3323-c985858d6ddb |
Aces |
Aces |
0497d585-42ad-61a7-42bc-189571f40e2c |
Clutches |
Clutches of 1v2 and higher |
3bc0563a-4fe9-a15c-0078-23a3408d64b5 |
Trades |
Trade kills; observed as an integer between 6 and 11 per match, awarded to several players at once |
745b27f0-4bc2-13a4-4ee7-77be323155c2 |
MVP |
Match MVP: a combined match rating capped at 500, awarded to exactly one player of the match |
4815a8a2-4649-9bfe-afd2-38ae9cc22898 |
Distinction |
The same value as the MVP goldstar (745b27f0-4bc2-13a4-4ee7-77be323155c2), but awarded to everyone above roughly 420 |
The MVP, Distinction and Trades values could not be reproduced from the data of the Match Details endpoint and are likely server-side stats that are not part of the match details. Any other ID returned by this endpoint is unknown - use its tempT internal name as a hint. Note that the units of the identified goldstars are not fixed either, see the Player Goldstars endpoint for how to determine them.
Headers
-
X-Riot-ClientPlatform: {client platform} -
X-Riot-ClientVersion: {client version} -
X-Riot-Entitlements-JWT: {entitlement token} -
Authorization: Bearer {auth token}
URL Parameters
Other Variables
-
client platformA string representing the platform of the client. Base-64 encoded JSON with the following fields:
{ "platformType": "PC", "platformOS": "Windows", "platformOSVersion": "10.0.19042.1.256.64bit", "platformChipset": "Unknown" }ew0KCSJwbGF0Zm9ybVR5cGUiOiAiUEMiLA0KCSJwbGF0Zm9ybU9TIjogIldpbmRvd3MiLA0KCSJwbGF0Zm9ybU9TVmVyc2lvbiI6ICIxMC4wLjE5MDQyLjEuMjU2LjY0Yml0IiwNCgkicGxhdGZvcm1DaGlwc2V0IjogIlVua25vd24iDQp9is a value that works. -
client version -
entitlement tokenCan be obtained locally with the Entitlements Token endpoint or remotely using Riot auth and the Entitlement endpoint -
auth tokenCan be obtained locally with the Entitlements Token endpoint or remotely by first using the Auth Cookies endpoint then using the cookies with the Auth Request endpoint
Response
type GoldstarsResponse = {
/** Goldstar ID. Known IDs (internal `tempT` name in parentheses):
- `6dc31cfd-41da-895f-9246-a8b63558cdb8` - damage per round / ADR (`Damage`)
- `2c8b6129-4384-230d-c7e5-cda12019533c` - headshot percentage of the match (`HeadshotPercentage`)
- `1b13755f-4d5a-2c9e-6a39-bea7e6c53e7f` - kills (`Kills`)
- `1c926cba-48cb-8aeb-c68d-a1ba2d012784` - top fragger of the match, value equals that player's kills (`TopFrag`)
- `e43f9acb-448c-4aa1-1591-6db72c0b8dae` - assists (`Assists`)
- `352a3ac8-4b2c-db6a-1f36-c0a67b428e65` - spike plants (`Plants`)
- `bfe96c47-44d0-e473-585d-749146d2d05e` - first kills (`FirstBlood`)
- `244cf4ab-4c27-cc59-3323-c985858d6ddb` - aces (`Aces`)
- `0497d585-42ad-61a7-42bc-189571f40e2c` - clutches of 1v2 and higher (`Clutches`)
- `3bc0563a-4fe9-a15c-0078-23a3408d64b5` - trade kills, observed as an integer between 6 and 11 per match, awarded to several players at once (`Trades`)
- `745b27f0-4bc2-13a4-4ee7-77be323155c2` - match MVP, a combined match rating capped at 500, awarded to exactly one player of the match (`MVP`)
- `4815a8a2-4649-9bfe-afd2-38ae9cc22898` - the same value as the MVP goldstar `745b27f0-4bc2-13a4-4ee7-77be323155c2` but awarded to everyone above roughly 420 (`Distinction`)
- any other ID - unknown, use its `tempT` internal name as a hint */
id: string;
/** Internal (dev) name of the goldstar, e.g. `TopFrag`, `HeadshotPercentage` or `MVP` */
tempT: string;
}[]; [
{
"id": "90261F3e-a4c9-F5Ed-B552-66fA0DCAfe5D",
"tempT": "caelum"
},
{
"id": "7b2cBdbb-afCA-7ad5-Fd4b-DEd78C37B6E8",
"tempT": "audacia"
},
{
"id": "4BAd3cd4-2F7C-0FaE-4125-daDEfbb05BD0",
"tempT": "illum"
},
{
"id": "86bdB078-7e4b-1a89-9cd8-2CBd12B7eABa",
"tempT": "vomito"
}
]