Skip to main content

​
What is Valaw?

Valaw is a fast, typed, asynchronous Python wrapper for the Official VALORANT API by Riot Games. It provides a clean, Pythonic interface for accessing match history, leaderboards, content, platform status, and console endpoints.

​
Why use Valaw?

Valaw is designed to make working with the VALORANT API simple and efficient:

Async-first

Built on aiohttp for non-blocking, high-performance requests

Typed responses

Returns typed objects instead of raw JSON for better IDE support and type safety

Full coverage

Supports all official PC and console endpoints for match, ranked, content, account, and status data

Modern Python

Compatible with Python 3.9 through 3.14

​
System requirements

  • Python: 3.9 or higher
  • Riot Games API Key: Required for authentication (Get your API key)
  • Dependencies: aiohttp (3.13.3) and dataclass_wizard (0.39.1)

​
Typed vs raw responses

By default, Valaw returns typed Python objects for all API responses:
client.py:149-150
client = valaw.Client("YOUR_API_KEY", "americas")
content = await client.GET_getContent("na", "en-US")
print(content.version)  # IDE autocomplete works!
If you prefer working with raw JSON dictionaries, you can opt out:
client.py:149-150
client = valaw.Client("YOUR_API_KEY", "americas", raw_data=True)
content = await client.GET_getContent("na", "en-US")
print(content["version"])  # Returns dict instead of ContentDto

​
Getting started

Ready to start building with Valaw? Follow our installation guide to get set up:

Installation

Install Valaw using pip or uv

​
Resources

Build docs developers (and LLMs) love

Get started for freeTalk to us