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

> Track Valorant player statistics, search for specific players, and view detailed competitive profiles to analyze individual performance. Discover current agent and map meta trends along with global rank distribution data to stay competitive and informed about the game's evolving strategies.

**Category:** Sports | **Website:** [valoranttracker.com/](https://valoranttracker.com/) | **Docs:** [parse.bot/marketplace/e7ccb09b-5995-4943-9736-b3b9a381b7dd/valoranttracker-com-api](https://parse.bot/marketplace/e7ccb09b-5995-4943-9736-b3b9a381b7dd/valoranttracker-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/valoranttracker/`
**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 agent insights

Get global meta insights for all Valorant agents. Returns the current patch version and per-agent statistics including pick rate, win rate, K/D ratio, and tier classification (S/A/B/C/D). One request returns all agents in the current meta.

**Estimated cost:** Metered

_No parameters required._

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

### Get map insights

Get global meta insights for all Valorant maps. Returns the total analyzed match count and per-map statistics including play frequency, K/D ratios for attackers and defenders, and win percentages. One request returns all active maps.

**Estimated cost:** Metered

_No parameters required._

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

### Get rank distribution

Get the ranked player distribution for a specific region. Returns every rank tier from Iron 1 through Radiant with player count, percentage, rank icon URL, and division color.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `region` | string | No | Region code. |

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

### Search player

Search for Valorant players by Riot ID. Returns a list of matching players with platform identifiers. Results are prefix/fuzzy matched, so a partial query may return multiple variants. Returns an empty array if no matches are found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Riot ID to search for (format: Name#Tag, e.g. 'TenZ#0505') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/valoranttracker/search-player \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<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.