Client Class
The main client for interacting with the VALORANT API.
Constructor
Client(token: str, cluster: str, raw_data: bool = False)
A Riot Games API access token used to authenticate requests.
The default cluster to use in requests. The nearest cluster to the host computer/server should be selected.Valid clusters:
americasasiaesportseurope
Whether to return raw JSON data instead of parsed objects. When False, API requests return typed objects. When True, API requests return raw dictionaries.
Example
import asyncio
from valaw import Client
async def main():
# Initialize client with americas cluster
client = Client(
token="RGAPI-your-api-key-here",
cluster="americas"
)
# Use the client for API calls
account = await client.GET_getByRiotId("PlayerName", "NA1")
print(f"Found account: {account.gameName}#{account.tagLine}")
# Always close the client when done
await client.close()
asyncio.run(main())
Example with Raw Data
import asyncio
from valaw import Client
async def main():
# Initialize client to return raw JSON
client = Client(
token="RGAPI-your-api-key-here",
cluster="americas",
raw_data=True
)
# Returns dictionary instead of AccountDto
account_data = await client.GET_getByRiotId("PlayerName", "NA1")
print(account_data) # {'puuid': '...', 'gameName': '...', 'tagLine': '...'}
await client.close()
asyncio.run(main())
Methods
close()
Close the aiohttp session. Always call this method when you’re done using the client to properly clean up resources.
Always close the client when done to prevent resource leaks. Consider using Python’s async with pattern or ensure close() is called in a finally block.
Example with Context Manager Pattern
import asyncio
from valaw import Client
class ValawClient:
def __init__(self, token, cluster):
self.client = Client(token, cluster)
async def __aenter__(self):
return self.client
async def __aexit__(self, exc_type, exc_val, exc_tb):
await self.client.close()
async def main():
async with ValawClient("RGAPI-your-api-key", "americas") as client:
account = await client.GET_getByRiotId("PlayerName", "NA1")
print(account.gameName)
# Client automatically closed
asyncio.run(main())
Exceptions
The client may raise the following exceptions:
InvalidCluster - Raised when an invalid cluster is providedInvalidRiotAPIKey - Raised when the API key is invalid or missingRiotAPIResponseError - Raised when the Riot API returns an error responseFailedToParseJSON - Raised when the response cannot be parsed as JSON
