# Dotabuff — 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 Dota 2 hero performance metrics from Dotabuff, including win rates, pick rates, ban rates, item builds, and lane statistics. Retrieve meta trend data and detailed per-hero attributes, roles, and ability information to support hero analysis and draft research.

**Category:** Sports | **Website:** [dotabuff.com/](https://dotabuff.com/) | **Docs:** [parse.bot/marketplace/7f1a5ae0-1a48-4f7d-9e99-8b5ce1804c5b/dotabuff-com-api](https://parse.bot/marketplace/7f1a5ae0-1a48-4f7d-9e99-8b5ce1804c5b/dotabuff-com-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/dotabuff/`
**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 hero details

Retrieve detailed statistics for a specific hero including base attributes (Strength, Agility, Intelligence with growth), roles, and popular items with match counts and win rates. Items are fetched from a secondary page and include the top 15 most-used items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `hero_slug` | string | Yes | The hero's URL slug (e.g., 'axe', 'storm-spirit', 'outworld-destroyer'). Obtainable from get_heroes_overview results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/dotabuff/get-hero-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"hero_slug":"<string>"}'
```

### Get heroes overview

Retrieve an overview of all heroes with statistics like win rate, pick rate, and ban rate. The view parameter selects the statistical dimension: winning (default) shows heroes sorted by win rate, played by pick rate, facets by hero facets with tier and rates, lanes by lane presence, damage by damage output, economy by gold metrics. Returns all ~127 heroes in a single page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `view` | string | No | The statistical view to fetch. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/dotabuff/get-heroes-overview \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"view":"<string>"}'
```

### Get lane stats

Retrieve hero performance statistics for a specific lane. Each hero entry includes lane presence percentage, win rate, KDA ratio, gold per minute (GPM), and experience per minute (XPM). Returns all heroes that have data for the requested lane, sorted by presence.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lane` | string | No | The lane to fetch statistics for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/dotabuff/get-lane-stats \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"lane":"<string>"}'
```

### Get meta trends

Retrieve meta trends showing win rate and pick rate changes over the recent period for all heroes. Heroes are sorted by biggest win rate change (positive first). Each entry shows the starting value, current value, and absolute change for both win rate and pick rate.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/dotabuff/get-meta-trends \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## 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.