Ranked Objects - Valaw

LeaderboardDto

Returned by GET_getLeaderboard and GET_getConsoleLeaderboard.

Field	Type	Description
`actId`	`str`	The act identifier
`players`	`list[PlayerDto]`	Leaderboard entries
`totalPlayers`	`int`	Total number of players on the leaderboard
`immortalStartingPage`	`int`	Page where Immortal rank begins
`immortalStartingIndex`	`int`	Index where Immortal rank begins
`topTierRRThreshold`	`int`	RR threshold for top tier players
`tierDetails`	`dict`	Tier-specific thresholds
`startIndex`	`int`	Starting index for this page
`shard`	`str`	Region/shard for this leaderboard
`query`	`str \| None`	Optional filter query

PlayerDto

A player entry on the leaderboard. Note: this is different from the PlayerDto in match objects.

Field	Type	Description
`leaderboardRank`	`int`	Position on the leaderboard (1 = top)
`rankedRating`	`int`	Current Ranked Rating (RR)
`numberOfWins`	`int`	Competitive wins for the act
`competitiveTier`	`int`	Competitive rank tier
`puuid`	`str`	Player’s PUUID (empty for private profiles)
`gameName`	`str`	In-game name (`"Private"` for private profiles)
`tagLine`	`str`	Tag line (empty for private profiles)

Players with private profiles will have gameName = "Private" and empty puuid and tagLine fields.

Competitive Tier Reference

Tier	Rank
0	Unranked
3	Iron 1
4	Iron 2
5	Iron 3
6	Bronze 1
7	Bronze 2
8	Bronze 3
9	Silver 1
10	Silver 2
11	Silver 3
12	Gold 1
13	Gold 2
14	Gold 3
15	Platinum 1
16	Platinum 2
17	Platinum 3
18	Diamond 1
19	Diamond 2
20	Diamond 3
21	Ascendant 1
22	Ascendant 2
23	Ascendant 3
24	Immortal 1
25	Immortal 2
26	Immortal 3
27	Radiant

Example

import valaw
import asyncio

async def main():
    client = valaw.Client("YOUR_TOKEN", "americas")
    try:
        leaderboard = await client.GET_getLeaderboard(
            actId="act-id-here",
            region="na",
            size=10
        )

        print(f"Total players: {leaderboard.totalPlayers}")
        for player in leaderboard.players:
            if player.gameName != "Private":
                print(f"  #{player.leaderboardRank} {player.gameName}#{player.tagLine} — {player.rankedRating} RR")
    finally:
        await client.close()

asyncio.run(main())