Client

Constructor

valaw.Client(token, cluster, raw_data=False)

Parameter	Type	Description
`token`	`str`	Your Riot Games API token
`cluster`	`str`	Default cluster for requests. Valid values: `americas`, `asia`, `esports`, `europe`
`raw_data`	`bool`	If `True`, returns raw JSON dicts instead of typed objects. Defaults to `False`

import valaw
import asyncio

async def main():
    client = valaw.Client("YOUR_TOKEN", "americas")
    try:
        account = await client.GET_getByRiotId("PlayerName", "NA1")
        print(f"{account.gameName}#{account.tagLine}")
    finally:
        await client.close()

asyncio.run(main())

Always call client.close() when done. Use a try/finally block to ensure it is always called even if an error occurs.

Account

GET_getByPuuid

await client.GET_getByPuuid(puuid, cluster=None)

Get an account by PUUID.

Parameter	Type	Description
`puuid`	`str`	The player’s PUUID
`cluster`	`str`, optional	Overrides the default cluster

Returns: AccountDto or dict

GET_getByRiotId

await client.GET_getByRiotId(gameName, tagLine, cluster=None)

Get an account by Riot ID (gameName#tagLine).

Parameter	Type	Description
`gameName`	`str`	The game name (left of `#`)
`tagLine`	`str`	The tag line (right of `#`)
`cluster`	`str`, optional	Overrides the default cluster

Returns: AccountDto or dict

GET_getByAccessToken

await client.GET_getByAccessToken(authorization, cluster=None)

Get the account associated with an RSO access token.

Parameter	Type	Description
`authorization`	`str`	The RSO access token
`cluster`	`str`, optional	Overrides the default cluster

Returns: AccountDto or dict

GET_getActiveShard

await client.GET_getActiveShard(puuid, cluster=None)

Get the active shard for a player.

Parameter	Type	Description
`puuid`	`str`	The player’s PUUID
`cluster`	`str`, optional	Overrides the default cluster

Returns: ActiveShardDto or dict

Content

GET_getContent

await client.GET_getContent(region, locale="")

Get game content (characters, maps, skins, etc.), optionally filtered by locale.

Parameter	Type	Description
`region`	`str`	Region to query. Valid values: `ap`, `br`, `esports`, `eu`, `kr`, `latam`, `na`
`locale`	`str`, optional	Locale for localized names. See Glossary for valid values. Input is case-insensitive

Returns: ContentDto or dict

Providing a locale results in faster response times from the API.

Match

GET_getMatch

await client.GET_getMatch(matchId, region)

Get full match details by match ID.

Parameter	Type	Description
`matchId`	`str`	The match ID
`region`	`str`	Region the match was played in

Returns: MatchDto or dict

GET_getMatchlist

await client.GET_getMatchlist(puuid, region)

Get a player’s match history.

Parameter	Type	Description
`puuid`	`str`	The player’s PUUID
`region`	`str`	The player’s region

Returns: MatchlistDto or dict

GET_getRecent

await client.GET_getRecent(queue, region)

Get recent match IDs for a queue. Returns matches completed in the last 10 minutes (or 12 hours for esports). NA, LATAM, and BR share a match history deployment.

Parameter	Type	Description
`queue`	`str`	Valid values: `competitive`, `unrated`, `spikerush`, `tournamentmode`, `deathmatch`, `onefa`, `ggteam`, `hurm`
`region`	`str`	Region to query

Returns: RecentMatchesDto or dict

Ranked

GET_getLeaderboard

await client.GET_getLeaderboard(actId, region, size=200, startIndex=0)

Get the competitive leaderboard for an act.

Parameter	Type	Description
`actId`	`str`	The act ID
`region`	`str`	Region to query
`size`	`int`	Number of entries to return (1–200). Defaults to `200`
`startIndex`	`int`	Starting index for pagination. Defaults to `0`

Returns: LeaderboardDto or dict

Console Match

GET_getConsoleMatch

await client.GET_getConsoleMatch(matchId, region)

Get full console match details by match ID.

Parameter	Type	Description
`matchId`	`str`	The match ID
`region`	`str`	Region the match was played in

Returns: MatchDto or dict

GET_getConsoleMatchlist

await client.GET_getConsoleMatchlist(puuid, region, platformType)

Get a console player’s match history.

Parameter	Type	Description
`puuid`	`str`	The player’s PUUID
`region`	`str`	The player’s region
`platformType`	`str`	Valid values: `playstation`, `xbox`

Returns: MatchlistDto or dict

GET_getConsoleRecent

await client.GET_getConsoleRecent(queue, region)

Get recent console match IDs for a queue.

Parameter	Type	Description
`queue`	`str`	Valid values: `console_unrated`, `console_swiftplay`, `console_hurm`, `console_competitive`, `console_deathmatch`
`region`	`str`	Region to query

Returns: RecentMatchesDto or dict

Console Ranked

GET_getConsoleLeaderboard

await client.GET_getConsoleLeaderboard(actId, region, platformType, size=200, startIndex=0)

Get the console competitive leaderboard for an act.

Parameter	Type	Description
`actId`	`str`	The act ID
`region`	`str`	Region to query
`platformType`	`str`	Valid values: `playstation`, `xbox`
`size`	`int`	Number of entries to return (1–200). Defaults to `200`
`startIndex`	`int`	Starting index for pagination. Defaults to `0`

Returns: LeaderboardDto or dict

Status

GET_getPlatformData

await client.GET_getPlatformData(region)

Get VALORANT platform status (maintenances and incidents) for a region.

Parameter	Type	Description
`region`	`str`	Region to query

Returns: PlatformDataDto or dict

RSO

create_RSO_link

client.create_RSO_link(redirect_uri, client_id, response_type, scopes, login_hint=None, ui_locales=None, state=None)

Constructs a Riot Sign-On (RSO) OAuth authorization URL. This is a regular synchronous method — no await needed.

Parameter	Type	Description
`redirect_uri`	`str`	OAuth2 callback URL
`client_id`	`str`	Your RSO application’s client ID
`response_type`	`str`	OAuth2 response type, typically `code`
`scopes`	`list[str]`	Scopes to request. Must include `openid`. Additional: `cpid`, `offline_access`
`login_hint`	`str`, optional	Pre-populate login page data
`ui_locales`	`list[str]`, optional	Preferred UI locales in order
`state`	`str`, optional	Opaque value returned to your redirect URI

Returns: str — the constructed authorization URL

Account Endpoints

Content Endpoints

Match Endpoints

Ranked Endpoints

Console Endpoints

Status Endpoints

RSO

Data Objects

Exceptions

Client

Constructor

Account

GET_getByPuuid

GET_getByRiotId

GET_getByAccessToken

GET_getActiveShard

Content

GET_getContent

Match

GET_getMatch

GET_getMatchlist

GET_getRecent

Ranked

GET_getLeaderboard

Console Match

GET_getConsoleMatch

GET_getConsoleMatchlist

GET_getConsoleRecent

Console Ranked

GET_getConsoleLeaderboard

Status

GET_getPlatformData

RSO

create_RSO_link

​Constructor

​Account

​GET_getByPuuid

​GET_getByRiotId

​GET_getByAccessToken

​GET_getActiveShard

​Content

​GET_getContent

​Match

​GET_getMatch

​GET_getMatchlist

​GET_getRecent

​Ranked

​GET_getLeaderboard

​Console Match

​GET_getConsoleMatch

​GET_getConsoleMatchlist

​GET_getConsoleRecent

​Console Ranked

​GET_getConsoleLeaderboard

​Status

​GET_getPlatformData

​RSO

​create_RSO_link

Constructor

Account

GET_getByPuuid

GET_getByRiotId

GET_getByAccessToken

GET_getActiveShard

Content

GET_getContent

Match

GET_getMatch

GET_getMatchlist

GET_getRecent

Ranked

GET_getLeaderboard

Console Match

GET_getConsoleMatch

GET_getConsoleMatchlist

GET_getConsoleRecent

Console Ranked

GET_getConsoleLeaderboard

Status

GET_getPlatformData

RSO

create_RSO_link