RiotWatcher

https://riot-watcher.readthedocs.io/en/latest
Admin
RiotWatcher is a thin Python wrapper library for the Riot Games API, supporting League of Legends,...
Tokens:29,396
Snippets:116
Trust Score:8.3
Update:10 months ago
Show doc for...
Tokens:
Raw
### Install RiotWatcher using pip or setup.py

Source: https://riot-watcher.readthedocs.io/en/latest/index

Instructions for installing the RiotWatcher library. This can be done using pip for straightforward installation or by running the setup.py script for more control.

```shell
pip install riotwatcher
```

```shell
python setup.py install
```

--------------------------------

### Challenges API V1 - Get All Challenge Configurations

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/LeagueOfLegends/ChallengesApiV1

Retrieves a list of all basic challenge configuration information for a given region.

```APIDOC
## GET /lol/challenges/v1/challenges

### Description
List of all basic challenge configuration information.

### Method
GET

### Endpoint
`/lol/challenges/v1/challenges`

### Parameters
#### Query Parameters
- **region** (string) - Required - The region to execute this request on.

### Response
#### Success Response (200)
- **ChallengeConfigInfoDto** (array) - A list of challenge configuration objects.

#### Response Example
```json
[
  {
    "challengeId": 1,
    "name": "Epic",
    "description": "Description of the challenge.",
    "levelTiers": [
      "string"
    ],
    "state": "ENABLED",
    "tracking": "RANKED_Solo_DUO"
  }
]
```
```

--------------------------------

### Challenges API V1 - Get Challenge Configuration by ID

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/LeagueOfLegends/ChallengesApiV1

Fetches the configuration details for a specific challenge based on its ID and region.

```APIDOC
## GET /lol/challenges/v1/challenges/{challengeId}

### Description
Get challenge configuration.

### Method
GET

### Endpoint
`/lol/challenges/v1/challenges/{challengeId}`

### Parameters
#### Path Parameters
- **challengeId** (long) - Required - The ID of the challenge.
- **region** (string) - Required - The region to execute this request on.

### Response
#### Success Response (200)
- **ChallengeConfigInfoDto** (object) - Contains the configuration details for the challenge.

#### Response Example
```json
{
  "challengeId": 1,
  "name": "Epic",
  "description": "Description of the challenge.",
  "levelTiers": [
    "string"
  ],
  "state": "ENABLED",
  "tracking": "RANKED_Solo_DUO"
}
```
```

--------------------------------

### Initialize ContentApi (Python)

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/Valorant/ContentApi

Initializes the ContentApi class, which requires a BaseApi object for making requests. This setup is necessary before calling any API methods within ContentApi.

```python
from riotwatcher._apis.valorant.content import ContentApi
from riotwatcher._apis.BaseApi import BaseApi

# Assuming base_api is an instance of BaseApi
# base_api = BaseApi(...)
# content_api = ContentApi(base_api)
```

--------------------------------

### Basic RiotWatcher Usage: Fetch Summoner and Champion Data

Source: https://riot-watcher.readthedocs.io/en/latest/index

Demonstrates basic usage of RiotWatcher to retrieve summoner information and champion data. It shows how to initialize the watcher, fetch summoner details by name, retrieve ranked statistics, and get champion lists using Data Dragon.

```python
from riotwatcher import LolWatcher, ApiError

lol_watcher = LolWatcher('<your-api-key>')

my_region = 'na1'

me = lol_watcher.summoner.by_name(my_region, 'pseudonym117')
print(me)

# all objects are returned (by default) as a dict
# lets see if i got diamond yet (i probably didnt)
my_ranked_stats = lol_watcher.league.by_summoner(my_region, me['id'])
print(my_ranked_stats)

# First we get the latest version of the game from data dragon
versions = lol_watcher.data_dragon.versions_for_region(my_region)
champions_version = versions['n']['champion']

# Lets get some champions
current_champ_list = lol_watcher.data_dragon.champions(champions_version)
print(current_champ_list)
```

--------------------------------

### GET /lol/match/v5/matches/{matchId}

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/LeagueOfLegends/MatchApiV5

Retrieves match details by match ID. This endpoint provides comprehensive information about a specific match.

```APIDOC
## GET /lol/match/v5/matches/{matchId}

### Description
Retrieves match details by match ID. This endpoint provides comprehensive information about a specific match.

### Method
GET

### Endpoint
/lol/match/v5/matches/{matchId}

### Parameters
#### Path Parameters
- **match_id** (string) - Required - The match ID.

#### Query Parameters
- **region** (string) - Required - The region to execute this request on

### Response
#### Success Response (200)
- MatchDto - Detailed match information.

```

--------------------------------

### TFT League API - Get League Entries

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/TeamFightTactics/LeagueApi

Retrieves all league entries for a given tier and division. Supports pagination. Requires region, tier, and division.

```APIDOC
## GET /tft-league-v1/entries/{tier}/{division}

### Description
Get all the league entries.

### Method
GET

### Endpoint
/tft-league-v1/entries/{tier}/{division}

### Parameters
#### Path Parameters
- **region** (str) - Required - The Riot Games region (e.g., 'na1', 'euw1').
- **tier** (str) - Required - The league tier (e.g., 'DIAMOND', 'PLATINUM').
- **division** (str) - Required - The league division (e.g., 'I', 'II', 'III', 'IV').

#### Query Parameters
- **page** (int) - Optional - The page number for pagination. Defaults to 1.

### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **Set[LeagueEntryDTO]** - A set of league entry DTOs matching the specified tier and division.

#### Response Example
```json
[
  {
    "summonerId": "some-summoner-id",
    "summonerName": "SummonerName",
    "leaguePoints": 500,
    "rank": "II",
    "wins": 60,
    "losses": 70,
    "hotStreak": false,
    "veteran": false,
    "freshBlood": true,
    "inactive": false
  }
]
```
```

--------------------------------

### Account API Endpoints

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/Riot/AccountApi

This section details the available endpoints for the Account API, including methods to get active shards, accounts by PUUID, and accounts by Riot ID.

```APIDOC
## GET /riot-watcher/AccountApi/active_shard

### Description
Retrieves the active shard for a given player based on their region, game, and PUUID.

### Method
GET

### Endpoint
/riot-watcher/AccountApi/active_shard

### Parameters
#### Query Parameters
- **region** (str) - Required - The region of the player.
- **game** (str) - Required - The game identifier.
- **puuid** (str) - Required - The player's PUUID.

### Response
#### Success Response (200)
- **ActiveShardDto** (object) - Data Transfer Object for active shard information.

#### Response Example
```json
{
  "game": "leagueoflegends",
  "activeShard": "na1"
}
```

## GET /riot-watcher/AccountApi/by_puuid

### Description
Fetches account details for a player using their PUUID.

### Method
GET

### Endpoint
/riot-watcher/AccountApi/by_puuid

### Parameters
#### Query Parameters
- **region** (str) - Required - The region of the player.
- **puuid** (str) - Required - The player's PUUID.

### Response
#### Success Response (200)
- **AcountDto** (object) - Data Transfer Object for account information.

#### Response Example
```json
{
  "puuid": "some_puuid_string",
  "gameName": "player_name",
  "tagLine": "ABCD"
}
```

## GET /riot-watcher/AccountApi/by_riot_id

### Description
Retrieves account information using the player's Riot ID (game name and tag line).

### Method
GET

### Endpoint
/riot-watcher/AccountApi/by_riot_id

### Parameters
#### Query Parameters
- **region** (str) - Required - The region of the player.
- **game_name** (str) - Required - The player's game name.
- **tag_line** (str) - Required - The player's tag line.

### Response
#### Success Response (200)
- **AccountDto** (object) - Data Transfer Object for account information.

#### Response Example
```json
{
  "puuid": "some_puuid_string",
  "gameName": "player_name",
  "tagLine": "ABCD"
}
```
```

--------------------------------

### GET /champion-rotations

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/LeagueOfLegends/ChampionApiV3

Retrieves champion rotation information for a specified region. This includes champions currently in the free-to-play rotation and those available for low-level accounts.

```APIDOC
## GET /champion-rotations

### Description
Retrieves champion rotation information, including free-to-play and low-level free-to-play rotations for a given region.

### Method
GET

### Endpoint
`/lol/platform/v3/championrotations/locale/{region}`

### Parameters
#### Path Parameters
- **region** (str) - Required - The region to retrieve champion rotations for.

#### Query Parameters
None

#### Request Body
None

### Request Example
```python
# Assuming 'watcher' is an initialized RiotWatcher object
watcher.champion.rotations(region='na1')
```

### Response
#### Success Response (200)
- **freeChampionIds** (list[int]) - A list of IDs for champions in the free rotation.
- **freeChampionIdsForNewPlayers** (list[int]) - A list of IDs for champions available in the low-level free rotation.
- **maxNewPlayerLevel** (int) - The maximum player level for which free champions are available.

#### Response Example
```json
{
  "freeChampionIds": [
    7,
    10,
    18,
    26,
    36,
    50,
    53,
    60,
    64,
    75,
    81,
    83,
    103,
    105,
    107,
    119,
    122,
    131,
    143,
    202
  ],
  "freeChampionIdsForNewPlayers": [
    26,
    35,
    41,
    47,
    57,
    67,
    77,
    84,
    90,
    101
  ],
  "maxNewPlayerLevel": 15
}
```
```

--------------------------------

### Initialize and Use LolWatcher (Python)

Source: https://riot-watcher.readthedocs.io/en/latest/_sources/index.rst

Demonstrates how to initialize the LolWatcher with an API key and fetch summoner, ranked, and champion data. It shows basic API calls and how returned data is structured as dictionaries. Handles potential ApiError exceptions for 404 and 429 status codes.

```python
from riotwatcher import LolWatcher, ApiError

lol_watcher = LolWatcher('<your-api-key>')

my_region = 'na1'

me = lol_watcher.summoner.by_name(my_region, 'pseudonym117')
print(me)

# all objects are returned (by default) as a dict
# lets see if i got diamond yet (i probably didnt)
my_ranked_stats = lol_watcher.league.by_summoner(my_region, me['id'])
print(my_ranked_stats)

# First we get the latest version of the game from data dragon
versions = lol_watcher.data_dragon.versions_for_region(my_region)
champions_version = versions['n']['champion']

# Lets get some champions
current_champ_list = lol_watcher.data_dragon.champions(champions_version)
print(current_champ_list)

# For Riot's API, the 404 status code indicates that the requested data wasn't found and
# should be expected to occur in normal operation, as in the case of a an
# invalid summoner name, match ID, etc.
#
# The 429 status code indicates that the user has sent too many requests
# in a given amount of time ("rate limiting").

try:
    response = lol_watcher.summoner.by_name(my_region, 'this_is_probably_not_anyones_summoner_name')
except ApiError as err:
    if err.response.status_code == 429:
        print('We should retry in {} seconds.'.format(err.headers['Retry-After']))
        print('this retry-after is handled by default by the RiotWatcher library')
        print('future requests wait until the retry-after time passes')
    elif err.response.status_code == 404:
        print('Summoner with that ridiculous name not found.')
    else:
        raise
```

--------------------------------

### TFT League API - Get Master League

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/TeamFightTactics/LeagueApi

Retrieves the master league for a specified region.

```APIDOC
## GET /tft-league-v1/master

### Description
Get the master league.

### Method
GET

### Endpoint
/tft-league-v1/master

### Parameters
#### Path Parameters
None

#### Query Parameters
- **region** (str) - Required - The Riot Games region (e.g., 'na1', 'euw1').

### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **LeagueListDTO** - Data transfer object representing a league list.

#### Response Example
```json
{
  "leagueId": "master-league-id",
  "tier": "MASTER",
  "entries": [
    {
      "summonerId": "some-summoner-id",
      "summonerName": "SummonerName",
      "leaguePoints": 900,
      "rank": "I",
      "wins": 90,
      "losses": 60,
      "hotStreak": true,
      "veteran": false,
      "freshBlood": true,
      "inactive": false
    }
  ]
}
```
```

--------------------------------

### TFT League API - Get Grandmaster League

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/TeamFightTactics/LeagueApi

Retrieves the grandmaster league for a specified region.

```APIDOC
## GET /tft-league-v1/grandmaster

### Description
Get the grandmaster league.

### Method
GET

### Endpoint
/tft-league-v1/grandmaster

### Parameters
#### Path Parameters
None

#### Query Parameters
- **region** (str) - Required - The Riot Games region (e.g., 'na1', 'euw1').

### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **LeagueListDTO** - Data transfer object representing a league list.

#### Response Example
```json
{
  "leagueId": "grandmaster-league-id",
  "tier": "GRANDMASTER",
  "entries": [
    {
      "summonerId": "some-summoner-id",
      "summonerName": "SummonerName",
      "leaguePoints": 1200,
      "rank": "I",
      "wins": 110,
      "losses": 45,
      "hotStreak": false,
      "veteran": true,
      "freshBlood": false,
      "inactive": false
    }
  ]
}
```
```

--------------------------------

### TFT League API - Get Challenger League

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/TeamFightTactics/LeagueApi

Retrieves the challenger league for a specified region.

```APIDOC
## GET /tft-league-v1/challenger

### Description
Get the challenger league.

### Method
GET

### Endpoint
/tft-league-v1/challenger

### Parameters
#### Path Parameters
None

#### Query Parameters
- **region** (str) - Required - The Riot Games region (e.g., 'na1', 'euw1').

### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **LeagueListDTO** - Data transfer object representing a league list.

#### Response Example
```json
{
  "leagueId": "challenger-league-id",
  "tier": "CHALLENGER",
  "entries": [
    {
      "summonerId": "some-summoner-id",
      "summonerName": "SummonerName",
      "leaguePoints": 1500,
      "rank": "I",
      "wins": 120,
      "losses": 40,
      "hotStreak": true,
      "veteran": true,
      "freshBlood": false,
      "inactive": false
    }
  ]
}
```
```

--------------------------------

### TftWatcher Initialization

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/TeamFightTactics/index

Initializes a new instance of the TftWatcher class for interacting with Team Fight Tactics APIs.

```APIDOC
## TftWatcher Initialization

### Description
Initializes a new instance of the TftWatcher class to interact with the Riot API for Team Fight Tactics.

### Method
Constructor

### Endpoint
N/A

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```python
from riotwatcher import TftWatcher

watcher = TftWatcher(api_key='YOUR_API_KEY')
```

### Response
#### Success Response (200)
N/A (Constructor returns an instance)

#### Response Example
N/A
```

--------------------------------

### GET /lol/champion-mastery/v4/champion-masteries/by-summoner/{encryptedSummonerId}/by-champion/{championId}

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/LeagueOfLegends/ChampionMasteryApiV4

Retrieves the champion mastery data for a specific champion for a given summoner.

```APIDOC
## GET /lol/champion-mastery/v4/champion-masteries/by-summoner/{encryptedSummonerId}/by-champion/{championId}

### Description
Get a specific champion's mastery entry for a given summoner ID.

### Method
GET

### Endpoint
/lol/champion-mastery/v4/champion-masteries/by-summoner/{encryptedSummonerId}/by-champion/{championId}

### Parameters
#### Path Parameters
- **encryptedSummonerId** (string) - Required - The summoner ID associated with the player.
- **championId** (long) - Required - The ID of the champion to retrieve mastery for.
- **region** (string) - Required - The region to execute this request on.

#### Query Parameters
None

#### Request Body
None

### Request Example
```
GET /lol/champion-mastery/v4/champion-masteries/by-summoner/someSummonerId/by-champion/267?region=na1
```

### Response
#### Success Response (200)
- **ChampionMasteryDTO** - Champion Mastery information for the specified player and champion.

#### Response Example
```json
{
  "championId": 267,
  "championLevel": 7,
  "championPoints": 150000,
  "lastPlayTime": 1678886400000,
  "chestGranted": true,
  "tokensEarned": 3
}
```
```

--------------------------------

### RiotWatcher Class Initialization

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/Riot/index

Initializes a new instance of the RiotWatcher class, which serves as the main interaction point with generic Riot APIs.

```APIDOC
## RiotWatcher Class

### Description
Initializes a new instance of the RiotWatcher class. This class is intended to be the main interaction point with the generic Riot APIs.

### Method
`__init__`

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Parameters
- **api_key** (string) - Required - The API key to use for this instance.
- **timeout** (int) - Optional - Time to wait for a response before timing out a connection to the Riot API.
- **rate_limiter** (riotwatcher.RateLimiter.RateLimiter) - Optional - Instance to be used for rate limiting. Defaults to `BasicRateLimiter`.
- **deserializer** (riotwatcher.Deserializer.Deserializer) - Optional - Instance to be used to deserialize responses from the Riot Api. Defaults to `DictionaryDeserializer`.

### Request Example
```python
from riotwatcher import RiotWatcher

watcher = RiotWatcher('YOUR_API_KEY')
```

### Response
#### Success Response (200)
This method does not return a value directly, but initializes the RiotWatcher object for use.

#### Response Example
```python
# No direct response, object is initialized
```
```

--------------------------------

### Initialize ValWatcher Class (Python)

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/Valorant/index

Initializes a new instance of the ValWatcher class for interacting with the Valorant API. Requires an API key and supports optional timeout, rate limiter, and deserializer configurations.

```python
from riotwatcher import ValWatcher

watcher = ValWatcher(api_key="YOUR_API_KEY")
```

--------------------------------

### Initialize LolWatcher with Kernel URL (Python)

Source: https://riot-watcher.readthedocs.io/en/latest/_sources/index.rst

Shows how to initialize the LolWatcher to use an external API proxy/caching server called 'kernel'. This is done by passing the 'kernel_url' parameter during instantiation. Subsequent watcher usage remains the same.

```python
from riotwatcher import LolWatcher, ApiError

lol_watcher = LolWatcher(kernel_url="https://your-kernel-instance") # should not contain trailing slash
# use watcher as normal
```

--------------------------------

### LolWatcher Initialization

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/LeagueOfLegends/index

Initializes a new instance of the LolWatcher class, which serves as the main interaction point with Riot Games APIs for League of Legends.

```APIDOC
## LolWatcher Class Initialization

### Description
Initializes a new instance of the LolWatcher class to interact with Riot Games APIs for League of Legends.

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```python
from riotwatcher import LolWatcher

watcher = LolWatcher("YOUR_API_KEY")
```

### Response
#### Success Response (Instance)
- **watcher** (LolWatcher) - An initialized LolWatcher instance.

#### Response Example
```python
# No direct response example, but the watcher object is created.
```
```

--------------------------------

### GET /lol/champion-mastery/v4/scores/by-summoner/{encryptedSummonerId}

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/LeagueOfLegends/ChampionMasteryApiV4

Retrieves a player's total champion mastery score, which is the sum of all their individual champion mastery levels.

```APIDOC
## GET /lol/champion-mastery/v4/scores/by-summoner/{encryptedSummonerId}

### Description
Get a player's total champion mastery score.

### Method
GET

### Endpoint
/lol/champion-mastery/v4/scores/by-summoner/{encryptedSummonerId}

### Parameters
#### Path Parameters
- **encryptedSummonerId** (string) - Required - The summoner ID associated with the player.
- **region** (string) - Required - The region to execute this request on.

#### Query Parameters
None

#### Request Body
None

### Request Example
```
GET /lol/champion-mastery/v4/scores/by-summoner/someSummonerId?region=na1
```

### Response
#### Success Response (200)
- **int** - The total champion mastery score for the player.

#### Response Example
```json
54200
```
```

--------------------------------

### TFT League API - Get Top Rated Ladders

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/TeamFightTactics/LeagueApi

Retrieves the top-rated ladders for a specified region and queue. Requires region and queue.

```APIDOC
## GET /tft-league-v1/ladders/top

### Description
Get the top rated ladders.

### Method
GET

### Endpoint
/tft-league-v1/ladders/top

### Parameters
#### Path Parameters
None

#### Query Parameters
- **region** (str) - Required - The Riot Games region (e.g., 'na1', 'euw1').
- **queue** (str) - Required - The queue ID (e.g., '1160' for TFT standard).

### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **TopRatedLadderEntryDto** - Data transfer object for top-rated ladder entries.

#### Response Example
```json
[
  {
    "summonerId": "some-summoner-id",
    "summonerName": "SummonerName",
    "leaguePoints": 1000,
    "rank": "I",
    "wins": 100,
    "losses": 50
  }
]
```
```

--------------------------------

### TFT Match API - Get Match By ID

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/TeamFightTactics/MatchApi

Retrieves a specific Team Fight Tactics match using its unique match ID.

```APIDOC
## GET /lol/match/v1/match/{matchId}

### Description
Fetches detailed information about a specific Team Fight Tactics match using its unique identifier.

### Method
GET

### Endpoint
`/lol/match/v1/match/{matchId}`

### Parameters
#### Path Parameters
- **matchId** (string) - Required - The unique identifier for the match.
- **region** (string) - Required - The region where the match took place.

### Request Example
```
GET /lol/match/v1/match/12345?region=na1
```

### Response
#### Success Response (200)
- **MatchDto** - An object containing detailed match data.

#### Response Example
```json
{
  "gameId": 12345,
  "participants": [
    {
      "puuid": "player_puuid_1",
      "teamId": 100,
      "placement": 1,
      "level": 8
    }
  ],
  "gameTimestamp": 1678886400000,
  "gameVersion": "13.6.500.5434"
}
```
```

--------------------------------

### Legends of Runeterra Watcher Initialization

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/LegendsOfRuneterra/index

Initialize a new instance of the LorWatcher class for interacting with the Legends of Runeterra API.

```APIDOC
## Initialize LorWatcher

### Description
Initializes the main interaction point with the Riot API for Legends of Runeterra.

### Method
Constructor

### Parameters
#### Path Parameters
* None

#### Query Parameters
* None

#### Request Body
* **api_key** (string) - Required - The API key to use for this instance.
* **timeout** (int) - Optional - Time to wait for a response before timing out a connection to the Riot API.
* **rate_limiter** (riotwatcher.RateLimiter.RateLimiter) - Optional - Instance to be used for rate limiting. Defaults to BasicRateLimiter.
* **deserializer** (riotwatcher.Deserializer.Deserializer) - Optional - Instance to be used to deserialize responses from the Riot Api. Defaults to DictionaryDeserializer.

### Request Example
```python
from riotwatcher import LorWatcher

watcher = LorWatcher(api_key="YOUR_API_KEY")
```

### Response
* None (Initialization does not return a response directly but creates an object for further API calls.)
```

--------------------------------

### GET /lol/match/v5/matchlists/by-puuid/{puuid}

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/LeagueOfLegends/MatchApiV5

Retrieves a list of match IDs associated with a given PUUID, allowing for filtering by queue, type, and time ranges.

```APIDOC
## GET /lol/match/v5/matchlists/by-puuid/{puuid}

### Description
Retrieves a list of match IDs associated with a given PUUID, allowing for filtering by queue, type, and time ranges.

### Method
GET

### Endpoint
/lol/match/v5/matchlists/by-puuid/{puuid}

### Parameters
#### Path Parameters
- **puuid** (string) - Required - The puuid.

#### Query Parameters
- **region** (string) - Required - The region to execute this request on
- **start** (int) - Optional - Defaults to 0. Start index.
- **count** (int) - Optional - Defaults to 20. Valid values: 0 to 100. Number of match ids to return.
- **queue** (int) - Optional - Filter the list of match ids by a specific queue id. This filter is mutually inclusive of the type filter meaning any match ids returned must match both the queue and type filters.
- **type** (string) - Optional - Filter the list of match ids by the type of match. This filter is mutually inclusive of the queue filter meaning any match ids returned must match both the queue and type filters.
- **start_time** (long) - Optional - Epoch timestamp in seconds. The matchlist started storing timestamps on June 16th, 2021. Any matches played before June 16th, 2021 won’t be included in the results if the startTime filter is set.
- **end_time** (long) - Optional - Epoch timestamp in seconds.

### Response
#### Success Response (200)
- List[string] - A list of match IDs.

```

--------------------------------

### Riot Watcher Handlers Overview

Source: https://riot-watcher.readthedocs.io/en/latest/_sources/riotwatcher/Handlers/index.rst

This section provides an overview of the different handler modules available in the Riot Watcher library. It includes submodules for rate limiting, serialization, error handling, and request handling.

```APIDOC
## Riot Watcher Handlers

This documentation outlines the various handler modules within the Riot Watcher library, categorized for clarity and efficient API interaction.

### Rate Limit Modules

Provides functionalities for managing API rate limits. Refer to the :ref:`rate-limiter` section for detailed information.

### Serialization Modules

Handles the deserialization of API responses into usable data structures.
- `riotwatcher.Handlers.DictionaryDeserializer`: Module for deserializing data into dictionaries.
- `riotwatcher.Handlers.DeserializerAdapter`: Adapter for deserialization processes.

### Error Handler Modules

Manages and processes errors returned from API requests.
- `riotwatcher.Handlers.DeprecationHandler`: Handles API deprecation notices.
- `riotwatcher.Handlers.ThrowOnErrorHandler`: Configures error throwing behavior.
- `riotwatcher.Handlers.TypeCorrectorHandler`: Corrects data types in responses.

### Request Handler Modules

Manages the process of making requests to the Riot Games API.
- `riotwatcher.Handlers.RequestHandler`: The primary module for handling API requests.
```

--------------------------------

### Initialize LolStatusApiV4

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/LeagueOfLegends/LolStatusApiV4

Initializes the LolStatusApiV4 class, which is used to interact with the League of Legends Status v4 API. It requires a BaseApi object for making requests.

```python
from riotwatcher._apis.league_of_legends import LolStatusApiV4

# Assuming base_api is an instance of riotwatcher.apis.BaseApi.BaseApi
status_api = LolStatusApiV4(base_api=base_api)
```

--------------------------------

### Challenges API V1 - Get Challenge Percentiles by ID

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/LeagueOfLegends/ChallengesApiV1

Retrieves a map of levels to player percentiles for a specific challenge in a given region.

```APIDOC
## GET /lol/challenges/v1/challenges/{challengeId}/percentiles

### Description
Map of level to percentile of players who have achieved it.

### Method
GET

### Endpoint
`/lol/challenges/v1/challenges/{challengeId}/percentiles`

### Parameters
#### Path Parameters
- **challengeId** (long) - Required - The ID of the challenge.
- **region** (string) - Required - The region to execute this request on.

### Response
#### Success Response (200)
- **Map[Level, double]** (object) - A map where keys are challenge levels and values are player percentiles.

#### Response Example
```json
{
  "ỉnhal": 0.955
}
```
```

--------------------------------

### GET /lol/champion-mastery/v4/champion-masteries/by-summoner/{encryptedSummonerId}

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/LeagueOfLegends/ChampionMasteryApiV4

Retrieves all champion mastery entries for a given summoner. This includes information on all champions the summoner has played and their mastery levels.

```APIDOC
## GET /lol/champion-mastery/v4/champion-masteries/by-summoner/{encryptedSummonerId}

### Description
Get all champion mastery entries for a specified summoner ID.

### Method
GET

### Endpoint
/lol/champion-mastery/v4/champion-masteries/by-summoner/{encryptedSummonerId}

### Parameters
#### Path Parameters
- **encryptedSummonerId** (string) - Required - The summoner ID associated with the player.
- **region** (string) - Required - The region to execute this request on.

#### Query Parameters
None

#### Request Body
None

### Request Example
```
GET /lol/champion-mastery/v4/champion-masteries/by-summoner/someSummonerId?region=na1
```

### Response
#### Success Response (200)
- **List[ChampionMasteryDTO]** - A list containing Champion Mastery information for the player and champion combinations.

#### Response Example
```json
[
  {
    "championId": 267,
    "championLevel": 7,
    "championPoints": 150000,
    "lastPlayTime": 1678886400000,
    "chestGranted": true,
    "tokensEarned": 3
  }
]
```
```

--------------------------------

### DataDragonApi Endpoints

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/LeagueOfLegends/DataDragonApi

This section covers the various methods available in the DataDragonApi to fetch game data like champions, items, maps, and more.

```APIDOC
## GET /data-dragon/champions

### Description
Retrieves a list of champions, optionally including all champion details.

### Method
GET

### Endpoint
/data-dragon/champions

### Parameters
#### Query Parameters
- **version** (str) - Required - The game version for which to retrieve data.
- **full** (bool) - Optional - If True, returns full champion details. Defaults to False.
- **locale** (str) - Optional - The locale for the data. Defaults to None.

### Request Example
```json
{
  "version": "13.10.1",
  "full": true,
  "locale": "en_US"
}
```

### Response
#### Success Response (200)
- **champions** (list) - A list of champion objects.

#### Response Example
```json
{
  "champions": [
    {
      "version": "13.10.1",
      "id": "Aatrox",
      "key": "266",
      "name": "Aatrox",
      "title": "the Darkin Blade",
      "image": {
        "full": "Aatrox.png",
        "sprite": "champion0.png",
        "group": "champion",
        "x": 0,
        "y": 0,
        "w": 48,
        "h": 48
      }
    }
  ]
}
```
```

```APIDOC
## GET /data-dragon/items

### Description
Retrieves a list of items available in the game.

### Method
GET

### Endpoint
/data-dragon/items

### Parameters
#### Query Parameters
- **version** (str) - Required - The game version for which to retrieve data.
- **locale** (str) - Optional - The locale for the data. Defaults to None.

### Request Example
```json
{
  "version": "13.10.1",
  "locale": "en_US"
}
```

### Response
#### Success Response (200)
- **items** (dict) - A dictionary where keys are item IDs and values are item objects.

#### Response Example
```json
{
  "items": {
    "1001": {
      "id": "1001",
      "name": "Boots of Speed",
      "description": "<stats>Movement Speed +25</stats>",
      "image": {
        "full": "1001.png",
        "sprite": "item0.png",
        "group": "item",
        "x": 0,
        "y": 0,
        "w": 32,
        "h": 32
      }
    }
  }
}
```
```

```APIDOC
## GET /data-dragon/languages

### Description
Retrieves a list of supported languages for game data.

### Method
GET

### Endpoint
/data-dragon/languages

### Parameters
#### Query Parameters
- **version** (str) - Required - The game version for which to retrieve data.
- **locale** (str) - Optional - The locale for the data. Defaults to None.

### Request Example
```json
{
  "version": "13.10.1",
  "locale": "en_US"
}
```

### Response
#### Success Response (200)
- **languages** (list) - A list of supported language codes.

#### Response Example
```json
{
  "languages": [
    "en_US",
    "es_ES",
    "fr_FR"
  ]
}
```
```

```APIDOC
## GET /data-dragon/maps

### Description
Retrieves map information for the game.

### Method
GET

### Endpoint
/data-dragon/maps

### Parameters
#### Query Parameters
- **version** (str) - Required - The game version for which to retrieve data.
- **locale** (str) - Optional - The locale for the data. Defaults to None.

### Request Example
```json
{
  "version": "13.10.1",
  "locale": "en_US"
}
```

### Response
#### Success Response (200)
- **maps** (dict) - A dictionary where keys are map IDs and values are map objects.

#### Response Example
```json
{
  "maps": {
    "11": {
      "MapName": "Summoner's Rift",
      "MapId": 11,
      "image": "map11.png"
    }
  }
}
```
```

```APIDOC
## GET /data-dragon/masteries

### Description
Retrieves mastery data for the game.

### Method
GET

### Endpoint
/data-dragon/masteries

### Parameters
#### Query Parameters
- **version** (str) - Required - The game version for which to retrieve data.
- **locale** (str) - Optional - The locale for the data. Defaults to None.

### Request Example
```json
{
  "version": "13.10.1",
  "locale": "en_US"
}
```

### Response
#### Success Response (200)
- **masteries** (list) - A list of mastery objects.

#### Response Example
```json
{
  "masteries": [
    {
      "id": 6111,
      "name": "Grasp of the Undying",
      "description": "Periodically, your next attack against an enemy champion will restore health,}`, 
      "icon": "mastery6111.png"
    }
  ]
}
```
```

```APIDOC
## GET /data-dragon/profile-icons

### Description
Retrieves profile icons available in the game.

### Method
GET

### Endpoint
/data-dragon/profile-icons

### Parameters
#### Query Parameters
- **version** (str) - Required - The game version for which to retrieve data.
- **locale** (str) - Optional - The locale for the data. Defaults to None.

### Request Example
```json
{
  "version": "13.10.1",
  "locale": "en_US"
}
```

### Response
#### Success Response (200)
- **profile_icons** (dict) - A dictionary where keys are profile icon IDs and values are profile icon objects.

#### Response Example
```json
{
  "profile_icons": {
    "0": {
      "id": "0",
      "image": "0.png"
    }
  }
}
```
```

```APIDOC
## GET /data-dragon/runes

### Description
Retrieves rune data for the game.

### Method
GET

### Endpoint
/data-dragon/runes

### Parameters
#### Query Parameters
- **version** (str) - Required - The game version for which to retrieve data.
- **locale** (str) - Optional - The locale for the data. Defaults to None.

### Request Example
```json
{
  "version": "13.10.1",
  "locale": "en_US"
}
```

### Response
#### Success Response (200)
- **runes** (list) - A list of rune objects.

#### Response Example
```json
{
  "runes": [
    {
      "id": 8005,
      "name": "Press the Attack",
      "description": "Attacking an enemy champion 3 times with attacks or abilities in combat will cause them to take bonus adaptive damage and make them vulnerable to all other damage for a short duration.",
      "icon": "rune8005.png"
    }
  ]
}
```
```

```APIDOC
## GET /data-dragon/runes-reforged

### Description
Retrieves reforged rune data for the game.

### Method
GET

### Endpoint
/data-dragon/runes-reforged

### Parameters
#### Query Parameters
- **version** (str) - Required - The game version for which to retrieve data.
- **locale** (str) - Optional - The locale for the data. Defaults to None.

### Request Example
```json
{
  "version": "13.10.1",
  "locale": "en_US"
}
```

### Response
#### Success Response (200)
- **runes_reforged** (list) - A list of reforged rune objects.

#### Response Example
```json
{
  "runes_reforged": [
    {
      "id": 8000,
      "name": "Domination",
      "key": "Domination",
      "slots": [
        {
          "runes": [
            {
              "id": 8005,
              "name": "Press the Attack",
              "description": "Attacking an enemy champion 3 times...",
              "shortDesc": "Attack an enemy champion 3 times...",
              "icon": "rune8005.png"
            }
          ]
        }
      ]
    }
  ]
}
```
```

```APIDOC
## GET /data-dragon/summoner-spells

### Description
Retrieves summoner spell data for the game.

### Method
GET

### Endpoint
/data-dragon/summoner-spells

### Parameters
#### Query Parameters
- **version** (str) - Required - The game version for which to retrieve data.
- **locale** (str) - Optional - The locale for the data. Defaults to None.

### Request Example
```json
{
  "version": "13.10.1",
  "locale": "en_US"
}
```

### Response
#### Success Response (200)
- **summoner_spells** (dict) - A dictionary where keys are summoner spell IDs and values are summoner spell objects.

#### Response Example
```json
{
  "summoner_spells": {
    "1": {
      "id": "1",
      "name": "Boost",
      "description": "Instantly break free of all snares, roots and slows and gain a burst of Haste.",
      "key": "SummonerBoost",
      "image": {
        "full": "SummonerBoost.png",
        "sprite": "spell0.png",
        "group": "spell",
        "x": 0,
        "y": 0,
        "w": 48,
        "h": 48
      }
    }
  }
}
```
```

```APIDOC
## GET /data-dragon/versions/all

### Description
Retrieves all available game versions.

### Method
GET

### Endpoint
/data-dragon/versions/all

### Parameters
None

### Response
#### Success Response (200)
- **versions** (list) - A list of all available game version strings.

#### Response Example
```json
{
  "versions": [
    "13.10.1",
    "13.9.1",
    "13.8.1"
  ]
}
```
```

```APIDOC
## GET /data-dragon/versions/region

### Description
Retrieves available game versions for a specific region.

### Method
GET

### Endpoint
/data-dragon/versions/region

### Parameters
#### Query Parameters
- **region** (str) - Required - The region for which to retrieve versions (e.g., 'na', 'euw').

### Request Example
```json
{
  "region": "na"
}
```

### Response
#### Success Response (200)
- **versions** (list) - A list of available game version strings for the specified region.

#### Response Example
```json
{
  "versions": [
    "13.10.1",
    "13.9.1"
  ]
}
```
```

--------------------------------

### Access Valorant Content API (Python)

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/Valorant/index

Provides an interface to the Content Endpoint of the Valorant API. This allows retrieval of game content information. No external dependencies are required beyond the ValWatcher instance.

```python
content_api = watcher.content
# Example usage:
# content = content_api.get_contents()

```

--------------------------------

### TFT League API - Get League by Summoner

Source: https://riot-watcher.readthedocs.io/en/latest/riotwatcher/TeamFightTactics/LeagueApi

Retrieves league entries for a given summoner ID. Requires region and encrypted summoner ID.

```APIDOC
## GET /tft-league-v1/entries/by-summoner/{encryptedSummonerId}

### Description
Get league entries for a given summoner ID.

### Method
GET

### Endpoint
/tft-league-v1/entries/by-summoner/{encryptedSummonerId}

### Parameters
#### Path Parameters
- **region** (str) - Required - The Riot Games region (e.g., 'na1', 'euw1').
- **encryptedSummonerId** (str) - Required - The encrypted ID of the summoner.

#### Query Parameters
None

### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **Set[LeagueEntryDTO]** - A set of league entry DTOs for the summoner.

#### Response Example
```json
[
  {
    "summonerId": "some-summoner-id",
    "summonerName": "SummonerName",
    "leaguePoints": 1000,
    "rank": "I",
    "wins": 100,
    "losses": 50,
    "hotStreak": true,
    "veteran": false,
    "freshBlood": false,
    "inactive": false
  }
]
```
```
Tokens:
Raw