# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-keeptradecut-com-api-b7c3ba52/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-keeptradecut-com-api-b7c3ba52/get_dynasty_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-keeptradecut-com-api-b7c3ba52/get_player_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-keeptradecut-com-api-b7c3ba52/get_recent_trades \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```