# Leagueofgraphs — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access League of Legends and Teamfight Tactics player statistics, rankings, and match histories. Look up summoner profiles, champion performance data, live game status, and competitive standings across both game modes and all supported regions.

**Category:** Sports | **Website:** [leagueofgraphs.com/](https://leagueofgraphs.com/) | **Docs:** [parse.bot/marketplace/b15f70eb-b043-49c5-b64c-0d71d6263824/leagueofgraphs-com-api](https://parse.bot/marketplace/b15f70eb-b043-49c5-b64c-0d71d6263824/leagueofgraphs-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-leagueofgraphs-com-api-b15f70eb/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_lol_champion_stats

Get comprehensive statistics for all League of Legends champions sorted by popularity. Includes win rate, pick rate, ban rate, KDA, primary role, and tier classification. Data reflects the current patch meta across all ranked games.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-leagueofgraphs-com-api-b15f70eb/get_lol_champion_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_lol_live_game

Check whether a specific summoner is currently in a live game. Inspects the summoner's profile page for live game indicators. Returns a boolean in_game flag and a human-readable status string.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Summoner Riot ID (format: Name-Tag or Name#Tag, e.g. Faker-KR1) |
| `region` | string | No | Region code for the summoner's server |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-leagueofgraphs-com-api-b15f70eb/get_lol_live_game \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>","region":"<string>"}'
```

### get_lol_rankings

Retrieve the top League of Legends players ranked by LP. Supports filtering by region and pagination. Each page returns approximately 100 players with their summoner name, region, tier, and LP.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based) |
| `region` | string | No | Region filter for rankings |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-leagueofgraphs-com-api-b15f70eb/get_lol_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","region":"<string>"}'
```

### get_lol_summoner_details

Retrieve a summoner's profile including rank tier and recent match history. Each match includes the champion played, result, KDA, game type, and duration. Also includes peak ranks from past seasons when available, showing the highest tier and LP achieved per season. The summoner is identified by Riot ID (Name#Tag or Name-Tag format) and region. Returns empty match_history and peak_ranks arrays if the profile exists but has no recent games or season history.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Summoner Riot ID (format: Name-Tag or Name#Tag, e.g. Faker-KR1) |
| `region` | string | No | Region code for the summoner's server |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-leagueofgraphs-com-api-b15f70eb/get_lol_summoner_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>","region":"<string>"}'
```

### get_tft_champion_stats

Get a list of all TFT champions available in the current set. Returns each champion's display name and URL slug for further lookups.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-leagueofgraphs-com-api-b15f70eb/get_tft_champion_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_tft_rankings

Retrieve the top Teamfight Tactics players ranked by LP. Supports filtering by region and pagination. Each page returns approximately 100 players with their summoner name, region, tier, LP, wins, and games played.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based) |
| `region` | string | No | Region filter for TFT rankings |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-leagueofgraphs-com-api-b15f70eb/get_tft_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","region":"<string>"}'
```