# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/dpm-lol/`
**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 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/credits/dpm-lol/get-champion-build \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/dpm-lol/get-champion-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/dpm-lol/get-leaderboard \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"is_pro":"<boolean>","page":"<integer>","platform":"<string>"}'
```

## Next steps

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