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

> Access data from keeptradecut.com.

**Category:** Sports | **Website:** [keeptradecut.com/](https://keeptradecut.com/) | **Docs:** [parse.bot/marketplace/b7c3ba52-2896-48b7-8cb3-883d36787c09/keeptradecut-com-api](https://parse.bot/marketplace/b7c3ba52-2896-48b7-8cb3-883d36787c09/keeptradecut-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/keeptradecut/`
**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 dynasty rankings

Retrieve dynasty fantasy football player rankings with crowdsourced trade values. Results are ordered by rank (highest value first). Each player includes their current trade value, positional rank, tier, and keep/trade/cut vote counts. The ranking pool is the top 500 dynasty-relevant players.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of players to return. |
| `position` | string | No | Filter by position. |
| `scoring` | string | No | Scoring format for values. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/keeptradecut/get-dynasty-rankings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","position":"<string>","scoring":"<string>"}'
```

### Get player details

Retrieve detailed information about a specific dynasty player including physical attributes, draft capital, and current trade value. The slug is the player's URL-safe identifier (e.g. 'josh-allen-365') available from the rankings endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `scoring` | string | No | Scoring format for values. |
| `slug` | string | Yes | Player URL slug from rankings (e.g. 'josh-allen-365', 'bijan-robinson-1414'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/keeptradecut/get-player-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"scoring":"<string>","slug":"<string>"}'
```

### Get recent trades

Retrieve recent real trades from dynasty fantasy football leagues. Trades are sourced from Sleeper, MFL, and other platforms. Each trade shows the player IDs exchanged between two teams and the league settings. Player IDs correspond to playerID values from the rankings endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of trades to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/keeptradecut/get-recent-trades \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

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