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.

​
Most Used Endpoints

Player Profile

Look up a player by tag

Clan Info

Fetch a clan and its details

Clan Members

Get the clan roster

Battle Log

Check recent battles
Most users start with player profile or clan info.

​
Player Profile

Get detailed player statistics and information.

​
Endpoint

GET /api/clashroyale/player/{playerTag}

​
Path Parameters

​
playerTag
string
required
Player tag (URL encoded, e.g., %23L22PCRC9V).

​
Example Request

cURL
curl -X GET "https://rocks.rive.wtf/api/clashroyale/player/%23L22PCRC9V" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
All Cards

Get information about all available cards in Clash Royale.

​
Endpoint

GET /api/clashroyale/cards

​
Example Request

cURL
curl -X GET "https://rocks.rive.wtf/api/clashroyale/cards" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Clan Info

Get detailed information about a clan.

​
Endpoint

GET /api/clashroyale/clan/{clanTag}

​
Path Parameters

​
clanTag
string
required
Clan tag (URL encoded, e.g., %23RGYCGY0V).

​
Example Request

cURL
curl -X GET "https://rocks.rive.wtf/api/clashroyale/clan/%23RGYCGY0V" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Clan Members

Get a list of all members in a clan.

​
Endpoint

GET /api/clashroyale/members/{clanTag}

​
Path Parameters

​
clanTag
string
required
Clan tag (URL encoded).

​
Search Clans

Search for clans by name.

​
Endpoint

GET /api/clashroyale/clansearch/{query}

​
Path Parameters

​
query
string
required
Search query (clan name).

​
Example Request

cURL
curl -X GET "https://rocks.rive.wtf/api/clashroyale/clansearch/Nova" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Player Chests

Get upcoming chest cycle for a player.

​
Endpoint

GET /api/clashroyale/chests/{playerTag}

​
Path Parameters

​
playerTag
string
required
Player tag (URL encoded).

​
Battle Log

Get recent battle history for a player.

​
Endpoint

GET /api/clashroyale/battlelog/{playerTag}

​
Path Parameters

​
playerTag
string
required
Player tag (URL encoded).

​
Example Request

cURL
curl -X GET "https://rocks.rive.wtf/api/clashroyale/battlelog/%23L22PCRC9V" \
  -H "Authorization: Bearer YOUR_API_KEY"
Remember to URL encode player and clan tags. # symbol should be encoded as %23.