# Tracker (tracker.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 Valorant player profiles, match histories, competitive rankings, and agent performance statistics from tracker.gg. Search leaderboards, analyze player segments, view daily game data, and access comprehensive reference information covering all Valorant-related data available on the platform.

**Category:** Sports | **Website:** [tracker.gg/](https://tracker.gg/) | **Docs:** [parse.bot/marketplace/3f7a7b29-71f1-4356-9b90-8d63cfceb3ea/tracker-gg-api](https://parse.bot/marketplace/3f7a7b29-71f1-4356-9b90-8d63cfceb3ea/tracker-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-tracker-gg-api-3f7a7b29/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_agent_insights

Get global agent performance insights including pick rates, win rates, K/D ratios, and tier rankings across all players for the current or specified act. Returns per-agent stats and daily usage histograms.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `act_id` | string | No | Act/season UUID. If not provided, uses the current act. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tracker-gg-api-3f7a7b29/get_agent_insights \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"act_id":"<string>"}'
```

### get_games_on_date

Get the number of games played by a player on a specific date. Fetches the player's match history and filters to matches on the target date. Limited to the most recent matches available in history.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Target date in YYYY-MM-DD format (e.g., '2024-12-07') |
| `player_id` | string | Yes | Player Riot ID in Name#Tag format (e.g., 'TenZ#00000'). Must use exact casing and tag number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tracker-gg-api-3f7a7b29/get_games_on_date \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","player_id":"<string>"}'
```

### get_leaderboard

Get the current ranked leaderboard for a specific region. Returns top players sorted by ranked rating (RR) for the current or specified act. Each entry includes player metadata, top agents, rank, and RR value.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `act_id` | string | No | Act/season UUID. If not provided, uses the current act. |
| `limit` | integer | No | Number of leaderboard entries to return (max 100) |
| `region` | string | No | Region code: na, eu, ap, kr, br, latam |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tracker-gg-api-3f7a7b29/get_leaderboard \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"act_id":"<string>","limit":"<integer>","region":"<string>"}'
```

### get_player_matches

Retrieve a player's recent competitive match history. Returns an array of match objects with map, mode, result, agent, and detailed per-match statistics including kills, deaths, damage, headshots, and performance score. Limited to the most recent matches available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_id` | string | Yes | Player Riot ID in Name#Tag format (e.g., 'TenZ#00000'). Must use exact casing and tag number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tracker-gg-api-3f7a7b29/get_player_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"<string>"}'
```

### get_player_profile

Get general player information and overview stats including platform info, user info, metadata, and season segments. Requires the exact Riot ID with correct casing and tag number. Returns platform details, user account info, privacy/season/playlist metadata, and stat segments for the player's default season.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_id` | string | Yes | Player Riot ID in Name#Tag format (e.g., 'TenZ#00000'). Must use exact casing and tag number as registered on Riot. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tracker-gg-api-3f7a7b29/get_player_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"<string>"}'
```

### get_player_segments

Get detailed player statistics broken down by segment type. Returns an array of segment objects each containing agent/map/weapon/season metadata and detailed stats (matchesPlayed, kDRatio, matchesWinPct, damage, headshots, etc.). Defaults to agent breakdown for competitive playlist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_id` | string | Yes | Player Riot ID in Name#Tag format (e.g., 'TenZ#00000'). Must use exact casing and tag number. |
| `season_id` | string | No | Act/season UUID to retrieve historical segment stats. Obtainable from get_reference_data with data_type=seasons. When omitted, returns stats for the current season. |
| `segment_type` | string | No | Segment type to retrieve: agent, map, weapon, season |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tracker-gg-api-3f7a7b29/get_player_segments \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"<string>","season_id":"<string>","segment_type":"<string>"}'
```

### get_reference_data

Retrieve reference database data for Valorant game entities. Returns arrays of items with UUIDs, names, and associated metadata. Supports agents (with roles, abilities), seasons (with episodes and date ranges), maps, weapons, and playlists.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `data_type` | string | Yes | Type of reference data: agents, seasons, maps, weapons, playlists |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tracker-gg-api-3f7a7b29/get_reference_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data_type":"<string>"}'
```