Client

The Client class is the main interface for interacting with the Valorant API.

class valopy.client.Client(api_key, redact_header=True)

Bases: object

Client for interacting with the Valorant API.

adapter

The adapter used for making HTTP requests.

Type:

Adapter

async close()

Close the client’s adapter session.

Return type:

None

async get_account_v1(name, tag, force_update=False)

Get Account V1 information.

Parameters:

• name (str) – The name of the account.

• tag (str) – The tag of the account.

• force_update (bool, default False) – Whether to force update the account information, by default False

Returns:

The Account V1 information.

Return type:

AccountV1

async get_account_v1_by_puuid(puuid, force_update=False)

Get Account V1 information by PUUID.

Parameters:

• puuid (str) – The player’s unique identifier (PUUID).

• force_update (bool, default False) – Whether to force update the account information, by default False

Returns:

The Account V1 information.

Return type:

AccountV1

async get_account_v2(name, tag, force_update=False)

Get Account V2 information.

Parameters:

• name (str) – The name of the account.

• tag (str) – The tag of the account.

• force_update (bool, default false) – Whether to force update the account information, by default False

Returns:

The Account V2 information.

Return type:

AccountV2

async get_account_v2_by_puuid(puuid, force_update=False)

Get Account V2 information by PUUID.

Parameters:

• puuid (str) – The player’s unique identifier (PUUID).

• force_update (bool, default false) – Whether to force update the account information, by default False

Returns:

The Account V2 information.

Return type:

AccountV2

async get_content(locale=None)

Get basic content data like season ids or skins.

Parameters:

locale (Optional[Locale]) – The locale for the content data, by default None

Returns:

The content data retrieved from the API.

Return type:

Content

async get_esports_schedule(region=None, league=None)

Get the esports schedule.

Parameters:

• region (Optional[EsportsRegion]) – Filter by esports region.

• league (Optional[League]) – Filter by esports league.

Returns:

List of esports events.

Return type:

List[EsportsEvent]

async get_leaderboard(region, platform, season=None, puuid=None, name=None, tag=None, size=None, start_index=None)

Get leaderboard for a specific region and platform.

Parameters:

• region (Region) – The region to get leaderboard for.

• platform (Platform) – The platform (PC or Console).

• season (Optional[Season]) – The season to filter by (e.g., Season.E9A3).

• puuid (Optional[str]) – Filter by player PUUID. Mutually exclusive with name and tag.

• name (Optional[str]) – Filter by player name. Must be used with tag.

• tag (Optional[str]) – Filter by player tag. Must be used with name.

• size (Optional[int]) – Number of players to return.

• start_index (Optional[int]) – Starting index for pagination.

Returns:

Leaderboard data with players and pagination info.

Return type:

Leaderboard

Raises:

ValoPyValidationError – If both puuid and name/tag are provided, or if name is provided without tag (or vice versa).

async get_queue_status(region)

Get the current queue status for a region.

Parameters:

region (Region) – The region to get queue status for.

Returns:

List of queue configurations for all available game modes.

Return type:

List[QueueData]

async get_status(region)

Get the current VALORANT server status for a region.

Parameters:

region (Region) – The region to get server status for.

Returns:

The server status including maintenances and incidents.

Return type:

Status

async get_version(region=Region.EU)

Get the current API version for a specific region.

Parameters:

region (Optional[Region]) – The region to get the API version for, by default Region.EU

Returns:

The version data retrieved from the API.

Return type:

Version

async get_website(countrycode)

Get website information for a specific country code.

Parameters:

countrycode (CountryCode) – The country code to get the website information for.

Returns:

A list of website content data.

Return type:

list[WebsiteContent]