# VLR.gg — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 professional esports competition data by retrieving live events, match results, detailed performance statistics for players and agents, current rankings, and team information. Monitor player performance metrics and agent usage across matches to stay updated on the competitive scene.

**Category:** Sports | **Website:** [vlr.gg/](https://vlr.gg/) | **Docs:** [parse.bot/marketplace/76e55d6e-208c-46d3-b3fe-b513779a90ee/vlr-gg-api](https://parse.bot/marketplace/76e55d6e-208c-46d3-b3fe-b513779a90ee/vlr-gg-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/vlr-gg/`
**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 active teams

Retrieve every active ranked team across all regions (or a specific region) from the full regional rankings. Returns all teams with their rank, rating, country, region, logo URL, and detail_path for use with get_team_details. When region is 'all', fetches teams from all 13 regions (north-america, europe, brazil, asia-pacific, korea, china, japan, la-s, la-n, oceania, mena, gc, collegiate). Results are auto-iterated across regions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `region` | string | No | Region to fetch teams from. Use 'all' to fetch every active team across all regions. |

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

### Get agent stats

Retrieve agent performance metrics (pick rates) for a specific event. Returns all agents with their pick rate percentage for the given event. Requires the event detail_path obtainable from get_events.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Event path (e.g., '2765/valorant-masters-london-2026'). Obtainable from get_events results detail_path field. |

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

### Get events

Retrieve current and upcoming Valorant esports events. Returns all events listed on the VLR.gg events page with their IDs, names, status, and detail paths for use with get_agent_stats.

**Estimated cost:** Metered

_No parameters required._

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

### Get match details

Retrieve detailed match data including per-map player statistics and aggregate all-maps stats. Returns team names, series score, event context, match format, stream links, date/time, and for each map played: individual player performance metrics (kills, deaths, assists, rating, ACS, KAST, ADR, headshot percentage, first kills/deaths). The all_maps object provides combined stats across all maps. Requires the full match path (match_id/slug) obtainable from get_matches detail_path field.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | string | Yes | Match path from the URL (e.g., '684618/global-esports-vs-xi-lai-gaming-valorant-masters-london-2026-r3-1-1'). Obtainable from get_matches results detail_path field. |

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

### Get matches

Retrieve upcoming matches or completed results with team names, scores, event context, and match status. Supports pagination for results. Each match includes a detail_path for use with get_match_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for results pagination. Only applies when status is 'results'. |
| `status` | string | No | Match status filter. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/vlr-gg/get-matches \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","status":"<string>"}'
```

### Get player stats

Retrieve the global player statistics leaderboard with performance metrics. Returns top players sorted by rating, filterable by time period, region, and agent played. Each player entry includes rounds played, rating, ACS, K/D, KAST, ADR, and other performance metrics.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `agent` | string | No | Filter by agent name (lowercase). Use 'all' for all agents. |
| `region` | string | No | Region filter. |
| `timespan` | string | No | Time period filter. |

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

### Get rankings

Retrieve team rankings by region. Returns ranked teams with their rating scores, country, and detail paths for use with get_team_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `region` | string | No | Region slug for rankings. |

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

### Get team details

Retrieve team roster, former players history, and map win rates for a specific team. Requires the team detail_path obtainable from get_rankings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_id` | string | Yes | Team path (e.g., '11058/g2-esports'). Obtainable from get_rankings results detail_path field. |

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

## Next steps

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