Valorant Assets API

A typed Python wrapper for the public Valorant API, built on pypercache.

Features

• Typed @apimodel schema resources for the main /v1 endpoints
• Built-in response caching via pypercache
• UUID lookups and collection methods
• Convenience helpers for playable agents, name-based lookup, active events, current season, and flattened contract rewards
• Convenience helpers for downloading assets and finding their path on disk
• Optional request logging

Install

pip install valorant-assets-api

For local development:

pip install -e .[test]

Usage

from valorant_assets_api import ValorantAPI

api = ValorantAPI()

for agent in api.list_agents(playable_only=True):
    print(agent.display_name, "-", agent.role.display_name if agent.role else "No role")

current_season = api.get_current_season()
version = api.get_version()

Documentation & Tutorial

Read the docs online, or start at docs/index.md for the Markdown version.

For a step-by-step walkthrough covering setup, localization, UUID lookups, convenience helpers, and cache configuration, see the tutorial notebook.

Endpoint Coverage

list_* and get_* methods map directly to public /v1 endpoints. Helper methods compose those calls into higher-level lookups.