Brawl Stars API - rocks.rive.wtf API

Player Profile

Get a player’s full profile including trophies, brawlers, and club info.

Endpoint

GET /api/brawlstars/player/{tag}

Path Parameters

tag

string

required

Player tag without the # symbol. Example: LGVY0QGP9

Example Request

cURL

curl -X GET "https://rocks.rive.wtf/api/brawlstars/player/LGVY0QGP9" \
  -H "Authorization: YOUR_API_KEY"

JavaScript

const response = await fetch('https://rocks.rive.wtf/api/brawlstars/player/LGVY0QGP9', {
  headers: {
    'Authorization': 'YOUR_API_KEY'
  }
});
const data = await response.json();
console.log(data);

Python

import requests
headers = {'Authorization': 'YOUR_API_KEY'}
response = requests.get(
    'https://rocks.rive.wtf/api/brawlstars/player/LGVY0QGP9',
    headers=headers
)
print(response.json())

Response Example

{
  "tag": "#LGVY0QGP9",
  "name": "Elox",
  "nameColor": "0xffff8afb",
  "icon": { "id": 28000065 },
  "trophies": 203209,
  "highestTrophies": 203209,
  "expLevel": 420,
  "expPoints": 894739,
  "totalPrestigeLevel": 200,
  "3vs3Victories": 92816,
  "soloVictories": 3402,
  "duoVictories": 1622,
  "bestRoboRumbleTime": 20,
  "bestTimeAsBigBrawler": 0,
  "club": {
    "name": "@toxicgenie"
  },
  "brawlers": [...]
}

Battle Log

Get a player’s recent battle history.

Endpoint

GET /api/brawlstars/battlelog/{tag}

Path Parameters

tag

string

required

Player tag without the # symbol. Example: LGVY0QGP9

Example Request

cURL

curl -X GET "https://rocks.rive.wtf/api/brawlstars/battlelog/LGVY0QGP9" \
  -H "Authorization: YOUR_API_KEY"

JavaScript

const response = await fetch('https://rocks.rive.wtf/api/brawlstars/battlelog/LGVY0QGP9', {
  headers: { 'Authorization': 'YOUR_API_KEY' }
});
const data = await response.json();
console.log(data.items);

Python

import requests
headers = {'Authorization': 'YOUR_API_KEY'}
response = requests.get(
    'https://rocks.rive.wtf/api/brawlstars/battlelog/LGVY0QGP9',
    headers=headers
)
print(response.json())

Response Example

{
  "items": [
    {
      "battleTime": "20260311T013212.000Z",
      "event": {
        "id": 15000143,
        "map": "Beach Ball",
        "mode": "brawlBall",
        "modeId": 5
      },
      "battle": {
        "mode": "brawlBall",
        "type": "ranked",
        "result": "victory",
        "duration": 54,
        "trophyChange": 8,
        "starPlayer": {
          "tag": "#JUQY88CY",
          "name": "raphlise",
          "brawler": {
            "id": 16000029,
            "name": "BEA",
            "power": 11,
            "trophies": 1883
          }
        },
        "teams": [[...], [...]]
      }
    }
  ]
}

Club

Get a club’s info and full member list.

Endpoint

GET /api/brawlstars/club/{tag}

Path Parameters

tag

string

required

Club tag without the # symbol. Example: 2QYU8PGV2

Example Request

cURL

curl -X GET "https://rocks.rive.wtf/api/brawlstars/club/2QYU8PGV2" \
  -H "Authorization: YOUR_API_KEY"

JavaScript

const response = await fetch('https://rocks.rive.wtf/api/brawlstars/club/2QYU8PGV2', {
  headers: { 'Authorization': 'YOUR_API_KEY' }
});
const data = await response.json();
console.log(data);

Python

import requests
headers = {'Authorization': 'YOUR_API_KEY'}
response = requests.get(
    'https://rocks.rive.wtf/api/brawlstars/club/2QYU8PGV2',
    headers=headers
)
print(response.json())

Response Example

{
  "tag": "#2QYU8PGV2",
  "name": "Tribe Turkey",
  "description": "IG:Kabus01|TT:Kabus0126|#FORCE",
  "type": "inviteOnly",
  "badgeId": 8000023,
  "requiredTrophies": 100000,
  "trophies": 3893832,
  "isFamilyFriendly": true,
  "members": [
    {
      "tag": "#90GJUJVLG",
      "name": "iAmNormex あ",
      "nameColor": "0xffffffff",
      "role": "vicePresident",
      "trophies": 143559,
      "icon": { "id": 28000244 }
    }
  ]
}

Club Members

Get only the members list for a club.

Endpoint

GET /api/brawlstars/club/{tag}/members

Path Parameters

tag

string

required

Club tag without the # symbol. Example: 2QYU8PGV2

Example Request

cURL

curl -X GET "https://rocks.rive.wtf/api/brawlstars/club/2QYU8PGV2/members" \
  -H "Authorization: YOUR_API_KEY"

Response Example

{
  "items": [
    {
      "tag": "#90GJUJVLG",
      "name": "iAmNormex あ",
      "nameColor": "0xffffffff",
      "role": "vicePresident",
      "trophies": 143559,
      "icon": { "id": 28000244 }
    }
  ]
}

Member Roles

Role	Description
`president`	Club owner
`vicePresident`	Vice president
`senior`	Senior member
`member`	Regular member

Global Player Rankings

Get the global top 200 player leaderboard.

Endpoint

GET /api/brawlstars/rankings/global/players

Example Request

cURL

curl -X GET "https://rocks.rive.wtf/api/brawlstars/rankings/global/players" \
  -H "Authorization: YOUR_API_KEY"

JavaScript

const response = await fetch('https://rocks.rive.wtf/api/brawlstars/rankings/global/players', {
  headers: { 'Authorization': 'YOUR_API_KEY' }
});
const data = await response.json();
console.log(data.items);

Response Example

{
  "items": [
    {
      "tag": "#LGVY0QGP9",
      "name": "Elox",
      "nameColor": "0xffff8afb",
      "icon": { "id": 28000065 },
      "trophies": 203209,
      "rank": 1,
      "club": { "name": "@toxicgenie" }
    }
  ]
}

Global Club Rankings

Get the global top 200 club leaderboard.

Endpoint

GET /api/brawlstars/rankings/global/clubs

Example Request

cURL

curl -X GET "https://rocks.rive.wtf/api/brawlstars/rankings/global/clubs" \
  -H "Authorization: YOUR_API_KEY"

Response Example

{
  "items": [
    {
      "tag": "#2QYU8PGV2",
      "name": "Tribe Turkey",
      "badgeId": 8000023,
      "trophies": 3893912,
      "memberCount": 30,
      "rank": 1
    }
  ]
}

Global Brawler Rankings

Get the global top 200 leaderboard for a specific brawler.

Endpoint

GET /api/brawlstars/rankings/global/brawlers/{brawlerId}

Path Parameters

brawlerId

number

required

Brawler ID. Example: 16000000 for Shelly.

Example Request

cURL

curl -X GET "https://rocks.rive.wtf/api/brawlstars/rankings/global/brawlers/16000000" \
  -H "Authorization: YOUR_API_KEY"

JavaScript

const response = await fetch('https://rocks.rive.wtf/api/brawlstars/rankings/global/brawlers/16000000', {
  headers: { 'Authorization': 'YOUR_API_KEY' }
});
const data = await response.json();
console.log(data.items);

Response Example

{
  "items": [
    {
      "tag": "#2UGGGJ0RJP",
      "name": "chattypineapple",
      "nameColor": "0xfff05637",
      "icon": { "id": 28001182 },
      "trophies": 3214,
      "rank": 1,
      "club": { "name": "shelly ❤️" }
    }
  ]
}

Common Brawler IDs

Brawler	ID
Shelly	`16000000`
Colt	`16000001`
Bull	`16000002`
Brock	`16000003`
Rico	`16000004`
Spike	`16000005`
Crow	`16000012`
Leon	`16000023`
Bibi	`16000026`
Stu	`16000045`
Mina	`16000097`

Use the /api/brawlstars/brawlers endpoint to get a full list of brawler IDs.

Brawlers List

Get a list of all brawlers with their star powers, gadgets, and hyper charges.

Endpoint

GET /api/brawlstars/brawlers

Example Request

cURL

curl -X GET "https://rocks.rive.wtf/api/brawlstars/brawlers" \
  -H "Authorization: YOUR_API_KEY"

Response Example

{
  "items": [
    {
      "id": 16000000,
      "name": "SHELLY",
      "starPowers": [
        { "id": 23000076, "name": "SHELL SHOCK" },
        { "id": 23000135, "name": "BAND-AID" }
      ],
      "gadgets": [
        { "id": 23000255, "name": "FAST FORWARD" },
        { "id": 23000288, "name": "CLAY PIGEONS" }
      ],
      "hyperCharges": [
        { "id": 23000613, "name": "DOUBLE BARREL" }
      ],
      "gears": [...]
    }
  ]
}

Single Brawler

Get detailed info on a specific brawler by ID.

Endpoint

GET /api/brawlstars/brawlers/{brawlerId}

Path Parameters

brawlerId

number

required

Brawler ID. Example: 16000000 for Shelly.

Example Request

cURL

curl -X GET "https://rocks.rive.wtf/api/brawlstars/brawlers/16000000" \
  -H "Authorization: YOUR_API_KEY"

Event Rotation

Get the current active event rotation.

Endpoint

GET /api/brawlstars/events/rotation

Example Request

cURL

curl -X GET "https://rocks.rive.wtf/api/brawlstars/events/rotation" \
  -H "Authorization: YOUR_API_KEY"

JavaScript

const response = await fetch('https://rocks.rive.wtf/api/brawlstars/events/rotation', {
  headers: { 'Authorization': 'YOUR_API_KEY' }
});
const data = await response.json();
console.log(data);

Response Example

[
  {
    "startTime": "20260311T000000.000Z",
    "endTime": "20260312T000000.000Z",
    "slotId": 1,
    "event": {
      "id": 15000143,
      "map": "Beach Ball",
      "mode": "brawlBall",
      "modeId": 5
    }
  }
]

Available Game Modes

Mode	Description
`brawlBall`	Brawl Ball ⚽
`gemGrab`	Gem Grab 💎
`heist`	Heist 💰
`bounty`	Bounty ⭐
`hotZone`	Hot Zone 🔥
`knockout`	Knockout 🥊
`soloShowdown`	Solo Showdown 💀
`duoShowdown`	Duo Showdown 👥
`siege`	Siege 🤖

The Authorization header uses your raw API key, not a Bearer token — pass it directly as the header value.

Getting Started

Social Media

Gaming

Sports

Entertainment

Utilities

​Player Profile

​Endpoint

​Path Parameters

​Example Request

​Response Example

​Battle Log

​Endpoint

​Path Parameters

​Example Request

​Response Example

​Club

​Endpoint

​Path Parameters

​Example Request

​Response Example

​Club Members

​Endpoint

​Path Parameters

​Example Request

​Response Example

​Member Roles

​Global Player Rankings

​Endpoint

​Example Request

​Response Example

​Global Club Rankings

​Endpoint

​Example Request

​Response Example

​Global Brawler Rankings

​Endpoint

​Path Parameters

​Example Request

​Response Example

​Common Brawler IDs

​Brawlers List

​Endpoint

​Example Request

​Response Example

​Single Brawler

​Endpoint

​Path Parameters

​Example Request

​Event Rotation

​Endpoint

​Example Request

​Response Example

​Available Game Modes

Player Profile

Endpoint

Path Parameters

Example Request

Response Example

Battle Log

Endpoint

Path Parameters

Example Request

Response Example

Club

Endpoint

Path Parameters

Example Request

Response Example

Club Members

Endpoint

Path Parameters

Example Request

Response Example

Member Roles

Global Player Rankings

Endpoint

Example Request

Response Example

Global Club Rankings

Endpoint

Example Request

Response Example

Global Brawler Rankings

Endpoint

Path Parameters

Example Request

Response Example

Common Brawler IDs

Brawlers List

Endpoint

Example Request

Response Example

Single Brawler

Endpoint

Path Parameters

Example Request

Event Rotation

Endpoint

Example Request

Response Example

Available Game Modes