# Metatft — 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.

> Discover optimal Teamfight Tactics team compositions with detailed stats on win rates, pick rates, recommended items, and star carries to improve your gameplay strategy. Search through current meta comps and get in-depth breakdowns of each composition's strengths and item builds.

**Category:** Sports | **Website:** [metatft.com/](https://metatft.com/) | **Docs:** [parse.bot/marketplace/5194af2c-7ceb-40ce-8b3f-b6f70748fa6e/metatft-com-api](https://parse.bot/marketplace/5194af2c-7ceb-40ce-8b3f-b6f70748fa6e/metatft-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-metatft-com-api-5194af2c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_comp_details

Retrieve detailed information about a specific team composition including full unit list, all item statistics, trait breakdowns, daily trend data, and extended build options. Requires a valid comp_id (cluster_id) obtained from the get_comps endpoint. Returns one composition's complete data including time-series trends for the past week.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `comp_id` | string | Yes | Cluster/comp ID from get_comps results (cluster_id field). |
| `queue` | string | No | Queue ID. 1100 is ranked TFT. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-metatft-com-api-5194af2c/get_comp_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"comp_id":"<string>","queue":"<string>"}'
```

### get_comps

Retrieve all TFT team compositions with their names, units, items, stars, win rates, pick rates, traits, and builds. Results are sorted by win rate (top-4 placement percentage). Each comp includes its best builds, top items, trait synergies, and overall stats aggregated across the specified rank tiers and time window. Pagination is not supported; a single response contains all recognized compositions (typically 50-80).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `days` | string | No | Number of days for stats aggregation. |
| `patch` | string | No | Patch filter. Use 'current' for the active patch. |
| `queue` | string | No | Queue ID. 1100 is ranked TFT. |
| `rank` | string | No | Comma-separated rank filter. Individual values: CHALLENGER, GRANDMASTER, MASTER, DIAMOND, EMERALD, PLATINUM. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-metatft-com-api-5194af2c/get_comps \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"days":"<string>","patch":"<string>","queue":"<string>","rank":"<string>"}'
```

### get_unit_items

Retrieve recommended items for each TFT unit with pick rates and average placement statistics. Returns up to 10 items per unit, sorted by unit pick rate descending. Covers all champions in the current TFT set. An optional name filter narrows results via case-insensitive substring match.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `unit_name` | string | No | Filter by unit name (case-insensitive partial match). Must be a champion name from the current TFT set (e.g. 'Braum', 'Corki', 'Jax'). Omitting returns all units. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-metatft-com-api-5194af2c/get_unit_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"unit_name":"<string>"}'
```