Examples

Working code examples demonstrating common usage patterns for the Riot Games API.

All examples are shown using the async RiotClient. You can use SyncRiotClient as a drop-in replacement — just remove async/await and use with instead of async with:

# Async
async with RiotClient() as client:
    account = await client.account.get_by_riot_id(...)

# Sync — same API, no async needed
with SyncRiotClient() as client:
    account = client.account.get_by_riot_id(...)

Available Examples

• League of Legends

  ---

  Summoner lookups, match history, champion mastery, live game spectator, error handling

• Teamfight Tactics

  ---

  TFT summoner data, match history, ranked leaderboards

• VALORANT

  ---

  Content data, platform status

Running the Examples

All examples require:

1. A valid Riot API key set as RIOT_API_KEY environment variable
2. The riotskillissue package installed

Linux / macOSWindows (PowerShell)Windows (CMD)

# Set your API key
export RIOT_API_KEY="RGAPI-your-key-here"

# Run an example
python examples/basic_usage.py

# Set your API key
$env:RIOT_API_KEY = "RGAPI-your-key-here"

# Run an example
python examples/basic_usage.py

# Set your API key
set RIOT_API_KEY=RGAPI-your-key-here

# Run an example
python examples/basic_usage.py

Included Example Scripts

The /examples directory in the repository contains runnable Python scripts:

Script	Description
basic_usage.py	Account lookup and summoner data
match_history.py	Fetching and processing match history
champion_mastery.py	Champion mastery rankings