# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-valoranttracker-com-api-e7ccb09b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-valoranttracker-com-api-e7ccb09b/get_agent_insights \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-valoranttracker-com-api-e7ccb09b/get_map_insights \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-valoranttracker-com-api-e7ccb09b/get_rank_distribution \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-valoranttracker-com-api-e7ccb09b/search_player \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```