# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/metatft/`
**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 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/credits/metatft/get-comp-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/metatft/get-comps \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/metatft/get-unit-items \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"unit_name":"<string>"}'
```

## Next steps

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