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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-vlr-gg-api-76e55d6e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-vlr-gg-api-76e55d6e/get_active_teams \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-vlr-gg-api-76e55d6e/get_agent_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-vlr-gg-api-76e55d6e/get_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-vlr-gg-api-76e55d6e/get_match_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-vlr-gg-api-76e55d6e/get_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-vlr-gg-api-76e55d6e/get_player_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-vlr-gg-api-76e55d6e/get_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-vlr-gg-api-76e55d6e/get_team_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_id":"<string>"}'
```