An open API service indexing awesome lists of open source software.

https://github.com/staciax/valorant

An API wrapper for Valorant-API.com written in Python.
https://github.com/staciax/valorant

asynchronous python python3 valorant valorant-api

Last synced: 8 days ago
JSON representation

An API wrapper for Valorant-API.com written in Python.

Awesome Lists containing this project

README

          

# valorant
An API wrapper for [Valorant API](https://valorant-api.com) written in Python.

## Features
- Supports all endpoints. (includes undocumented endpoints)
- Fully type annotated.
- [Pydantic V2](https://docs.pydantic.dev/latest/) models.
- Supports Python 3.10+.
- Supports all languages.
- Caching support with SQLite backend (enabled by default).

## Installing
To install the library, you can just run the following command:
```
# uv
uv add valorant.py

# pip
pip install valorant.py
```

### Optional Dependencies

**Speed** - Faster JSON parsing with `msgspec`:
```
uv add "valorant.py[speed]"
```

> [!WARNING]
> `msgspec` does not currently support Python 3.14 and 3.14t. See [issue #171](https://github.com/jcrist/msgspec/issues/926).

## Quick Example
```py
import asyncio
import valorant

async def main() -> None:
async with valorant.Client() as client:
weapons = await client.fetch_weapons()
for weapon in weapons:
print(weapon.display_name)
print(weapon.display_icon)

asyncio.run(main())
```

## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Links
- [Valorant API](https://valorant-api.com)
- [Official Discord Server](https://discord.com/invite/9V5MWgD)