Skip to main content

Documentation Index

Fetch the complete documentation index at: https://rocks.docs.rive.wtf/llms.txt

Use this file to discover all available pages before exploring further.

Every API key is tied to one IP. To apply for a key, DM southctrl on Discord.
Use the endpoint path below, replace the required params, and send Authorization: Bearer YOUR_API_KEY.

​
Quick Start

1

Choose a player

Use the Riot name and tag required by the route.
2

Call the stats route

Send the request with your Bearer token.
3

Use the result

Read rank, account, and stat data from the response.
Good for stat lookup commands, trackers, and profile cards.

​
Get Player Stats

Get detailed statistics and rank information for a Valorant player.

​
Endpoint

GET /api/valorant/{name}/{tag}

​
Path Parameters

​
name
string
required
Player’s Riot ID name.
​
tag
string
required
Player’s Riot ID tag (without #).

​
Example Request

curl -X GET "https://rocks.rive.wtf/api/valorant/TenZ/00005" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Example Response

{
  "accountLevel": 461,
  "card": {
    "large": "https://media.valorant-api.com/playercards/e6773d10-4a98-1ddf-d2c8-0783708dffb5/largeart.png",
    "wide": "https://media.valorant-api.com/playercards/e6773d10-4a98-1ddf-d2c8-0783708dffb5/wideart.png"
  },
  "elo": 2372,
  "name": "TenZ",
  "puuid": "e78609dd-dbad-54f1-8e08-2bae51861f09",
  "rank": 26,
  "rankImage": "https://media.valorant-api.com/competitivetiers/03621f52-342b-cf4e-4f86-9350a49c6d04/26/largeicon.png",
  "rankRating": 272,
  "region": "NA",
  "status": "Online",
  "tag": "00005",
  "trackerUrl": "https://tracker.gg/valorant/profile/riot/TenZ%2300005/overview"
}

​
Response Fields

​
name
string
Player’s Riot ID name
​
tag
string
Player’s Riot ID tag
​
puuid
string
Player’s unique identifier (PUUID)
​
accountLevel
number
Player’s account level
​
region
string
Player’s region (e.g., “NA”, “EU”, “AP”)
​
status
string
Player’s online status (e.g., “Online”, “Offline”)
​
rank
number
Numeric rank tier value
​
rankRating
number
Ranked Rating (RR) points within current rank
​
elo
number
Player’s ELO/MMR rating
​
rankImage
string
URL to the player’s rank badge image
​
card
object
Player card artwork URLs
  • large - Large player card image
  • wide - Wide player card image
​
trackerUrl
string
Link to the player’s profile on tracker.gg

​
Rank Tiers

TierRank
3-5Iron 1-3
6-8Bronze 1-3
9-11Silver 1-3
12-14Gold 1-3
15-17Platinum 1-3
18-20Diamond 1-3
21-23Ascendant 1-3
24-26Immortal 1-3
27Radiant

​
Region Codes

Common region codes:
  • NA - North America
  • EU - Europe
  • AP - Asia Pacific
  • KR - Korea
  • LATAM - Latin America
  • BR - Brazil
Riot ID consists of a name and tag (e.g., “TenZ#00005”). Make sure to separate them in the API path without the # symbol.
rankRating field shows RR (Ranked Rating) points within the current rank tier. For example, 272 RR in Immortal 3.

​
Use Cases

Discord Rank Checker

Display player stats in Discord servers

Team Roster Management

Track your team’s ranks and stats

Stat Tracking Websites

Build Valorant stat tracking platforms

Tournament Tools

Verify player ranks for tournaments