MarvelRivalsAPI.com
  1. Player Stats
MarvelRivalsAPI.com
  • Introduction
  • Get Started
    • Authentication
    • Rate Limits
    • Errors
      • Status Codes
    • SDKs & Extentions
      • Community Libraries
  • Endpoints
    • Achievements
      • List achievements
      • Search achievement
    • Patch Notes
      • List balances
      • Search balance
      • List dev diaries
      • Search dev diary
      • List patch notes
      • Search patch note
      • List game versions
    • Battle Pass
      • Battlepass
    • Heroes
      • List Heroes
      • Search hero
      • Hero stats
      • Hero leaderboard
      • List costumes
      • Search hero costume
    • Items
      • List items
      • Search item
    • Maps
      • List maps
      • Search map
    • Player Match History
      • Search match
      • Player match history
      • Player match history v2
    • Player Stats
      • Search player
        GET
      • Player stats
        GET
      • Player stats v2
        GET
      • Update player
        GET
      • Player Leaderboard
        GET
  1. Player Stats

Player Leaderboard

GET
/api/v2/players/leaderboard
Player Stats
Maintainer:Alastor

Request

Query Params

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://marvelrivalsapi.com/api/v2/players/leaderboard?page=&limit=&device=&season='
Response Response Example
{
    "page": 1,
    "limit": 25,
    "total_players": 500,
    "total_pages": 20,
    "players": [
        {
            "score": 2205113,
            "uid": "1362318547",
            "name": "pølly",
            "icon": {
                "player_icon_id": "31022203",
                "player_icon": "/players/heads/player_head_31022203.png"
            },
            "rank": {
                "rank": {
                    "rank": "Eternity",
                    "image": "/ranked/eternity.png",
                    "color": "#FF4F4D"
                },
                "win_rate": "68.9%",
                "max_level": 23,
                "rank_score": 5113.6921849402,
                "protect_score": 0,
                "diff_score": 16.227694418965,
                "season_number": 2,
                "win_count": 73,
                "level": 22,
                "max_rank_score": 5113.6921849402,
                "season_max_level": 23,
                "battle_count": 106
            }
        },
        {
            "score": 2205109,
            "uid": "189146510",
            "name": "рokey",
            "icon": {
                "player_icon_id": "31016204",
                "player_icon": "/players/heads/player_head_31016204.png"
            },
            "rank": {
                "rank": {
                    "rank": "Eternity",
                    "image": "/ranked/eternity.png",
                    "color": "#FF4F4D"
                },
                "win_rate": "65.7%",
                "max_level": 23,
                "rank_score": 5109.0443056035,
                "protect_score": 0,
                "diff_score": 12.498423710025,
                "season_number": 2,
                "win_count": 90,
                "level": 22,
                "max_rank_score": 5109.0443056035,
                "season_max_level": 23,
                "battle_count": 137
            }
        },
        {
            "score": 2205103,
            "uid": "1822797559",
            "name": "cооper",
            "icon": {
                "player_icon_id": "31038204",
                "player_icon": "/players/heads/player_head_31038204.png"
            },
            "rank": {
                "rank": {
                    "rank": "One Above All",
                    "image": "/ranked/one_above_all.png",
                    "color": "#FF4F4D"
                },
                "win_rate": "72%",
                "max_level": 23,
                "rank_score": 5103.0905286786,
                "protect_score": 0,
                "diff_score": 11.902376239289,
                "season_number": 2,
                "win_count": 90,
                "level": 23,
                "max_rank_score": 5103.0905286786,
                "season_max_level": 23,
                "battle_count": 125
            }
        },
    ]
}
Modified at 2025-07-24 14:12:33
Previous
Update player
Built with