# DPM.lol — 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.

> Look up League of Legends champion builds, tier lists, and leaderboard rankings from dpm.lol to optimize your gameplay. Search through champion data and discover the best builds for any champion you want to master.

**Category:** Sports | **Website:** [dpm.lol/](https://dpm.lol/) | **Docs:** [parse.bot/marketplace/b892cf34-454f-4c1a-9fe3-ff56a899bfdc/dpm-lol-api](https://parse.bot/marketplace/b892cf34-454f-4c1a-9fe3-ff56a899bfdc/dpm-lol-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-dpm-lol-api-b892cf34/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_champion_build

Retrieves the recommended build for a champion in a specific lane: items (by slot), runes, summoner spells, boots, core build paths, and skill level-up order. Each option includes winrate and pickrate. One request per champion-lane.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `champion_name` | string | Yes | Champion name exactly as returned by get_champion_list (e.g. Ahri, Jinx, RekSai). Case sensitive. |
| `lane` | string | Yes | Lane in lowercase. |
| `tier` | string | No | Rank tier filter. |
| `timeframe` | string | No | Patch version (e.g. 16.13, 16.12, 16.11). When omitted, the current live patch is auto-detected. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dpm-lol-api-b892cf34/get_champion_build \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"champion_name":"<string>","lane":"<string>","tier":"<string>","timeframe":"<string>"}'
```

### get_champion_list

Retrieves all champions with per-lane stats (winrate, pickrate, banrate, tier score) for a given patch and rank tier. Each champion-lane combination is a separate entry. Returns the full roster in a single page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_mode` | string | No | Game mode. Currently only ranked is supported. |
| `tier` | string | No | Rank tier filter. |
| `timeframe` | string | No | Patch version (e.g. 16.13, 16.12, 16.11). When omitted, the current live patch is auto-detected. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dpm-lol-api-b892cf34/get_champion_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game_mode":"<string>","tier":"<string>","timeframe":"<string>"}'
```

### get_leaderboard

Retrieves the ranked solo-queue leaderboard for a platform (region). Each page contains up to 100 players ordered by LP. Includes rank details, main lane, champion pool, KDA, live-game status, and team/role tags. Pass page to paginate manually.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `is_pro` | boolean | No | When true, filters to pro players only. |
| `page` | integer | No | Page number (1-based). |
| `platform` | string | No | Platform/region identifier. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dpm-lol-api-b892cf34/get_leaderboard \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"is_pro":"<boolean>","page":"<integer>","platform":"<string>"}'
```
