Build with the VALORANT API

Valaw is an async Python wrapper for the Official VALORANT API by Riot Games. Get typed responses, full endpoint coverage, and a developer-friendly interface.

Get Started API Reference

import valaw
import asyncio

async def main():
    client = valaw.Client("YOUR_RIOT_API_TOKEN", "americas")
    try:
        # Get account by Riot ID
        account = await client.GET_getByRiotId("Player", "TAG")
        print(f"Found: {account.gameName}#{account.tagLine}")
        
        # Get match history
        matches = await client.GET_getMatchlist(
            account.puuid, 
            "na"
        )
        print(f"Matches: {len(matches.history)}")
    finally:
        await client.close()

asyncio.run(main())

Get started in minutes

Install Valaw and make your first API call

Install the package

Install Valaw using pip or uv:

pip install valaw

Get your Riot API key

Create a free developer account at developer.riotgames.com and generate your API key. Keep it secure and never commit it to version control.

Development API keys expire after 24 hours. For production use, apply for a production key through the Riot Developer Portal.

Initialize the client

Create a client instance with your API key and preferred cluster:

import valaw

# Choose your cluster: americas, asia, europe, or esports
client = valaw.Client("YOUR_RIOT_API_TOKEN", "americas")

Select the cluster closest to your server location for best performance.

Make your first request

Query the API and get typed responses:

import asyncio

async def main():
    client = valaw.Client("YOUR_RIOT_API_TOKEN", "americas")
    try:
        # Get game content
        content = await client.GET_getContent("na", "en-US")
        print(f"Acts: {len(content.acts)}")
        print(f"Characters: {len(content.characters)}")
    finally:
        await client.close()

asyncio.run(main())

Example output

Acts: 15
Characters: 25

Explore by topic

Everything you need to build with the VALORANT API

Account endpoints

Look up players by Riot ID, PUUID, or access token

Match data

Retrieve detailed match history and statistics

Ranked leaderboards

Access competitive leaderboards by act and region

Console support

Query PlayStation and Xbox VALORANT data

Error handling

Handle API errors and response codes gracefully

Examples

Real-world code samples and usage patterns

Why choose Valaw?

Built for developers who need speed, type safety, and reliability

Async-first

Built on aiohttp for non-blocking requests. Perfect for high-throughput applications and concurrent API calls.

Fully typed

Returns typed Python objects instead of raw JSON. Get autocomplete and type checking in your IDE.

Complete coverage

All official VALORANT API endpoints including PC, console, ranked, match, and content data.

Ready to start building?

Follow the quickstart guide to make your first API call in under 5 minutes.

View Quickstart