# Leagueofgraphs — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/leagueofgraphs/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/leagueofgraphs/get-lol-champion-stats \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/leagueofgraphs/get-lol-live-game \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/leagueofgraphs/get-lol-rankings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/leagueofgraphs/get-lol-summoner-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/leagueofgraphs/get-tft-champion-stats \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/leagueofgraphs/get-tft-rankings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","region":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.