# Tracker (api.tracker.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.

> Look up any Rocket League player's complete profile stats including their lifetime achievements, ranked ratings across all playlists, and season rewards all in one place. Get instant access to detailed competitive performance data to track player progress and compare rankings.

**Category:** Sports | **Website:** [api.tracker.gg/api/v2/rocket-league/standard/profile/](https://api.tracker.gg/api/v2/rocket-league/standard/profile/) | **Docs:** [parse.bot/marketplace/2b3cf38a-5a6d-4456-ab74-560915397bdb/api-tracker-gg-api](https://parse.bot/marketplace/2b3cf38a-5a6d-4456-ab74-560915397bdb/api-tracker-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/tracker-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 profile

Fetch a Rocket League player's full profile data including platform info, lifetime stats (wins, goals, MVPs, saves, assists, shots), and per-playlist ranked ratings for the current season. Returns the raw API response from Tracker.gg. Requires both a platform slug and a player identifier.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `platform` | string | Yes | Gaming platform slug identifying where the player account lives (e.g. epic, steam, psn, xbl). |
| `player_id` | string | Yes | Player identifier on the given platform. For Epic this is the display name; for Steam this is the 64-bit Steam ID. |

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

### 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.beta.paywithlocus.com/api/wrapped/credits/tracker-gg/get-agent-insights \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/tracker-gg/get-games-on-date \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/tracker-gg/get-leaderboard \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/tracker-gg/get-player-matches \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/tracker-gg/get-player-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/tracker-gg/get-player-segments \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/tracker-gg/get-reference-data \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"data_type":"<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.