# Rosteraudit — 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 real-time dynasty fantasy football rankings and player trade values powered by an Elo engine that analyzes actual trades from thousands of Sleeper leagues. Search for players and instantly discover their current market value to optimize your roster decisions.

**Category:** Sports | **Website:** [rosteraudit.com/developers/](https://rosteraudit.com/developers/) | **Docs:** [parse.bot/marketplace/0df80132-239a-4553-97df-7b36fed4d070/rosteraudit-com-api](https://parse.bot/marketplace/0df80132-239a-4553-97df-7b36fed4d070/rosteraudit-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-rosteraudit-com-api-0df80132/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_dynasty_rankings

Get dynasty player rankings with optional filtering by scoring format, position, sort order, age range, and league size. Returns paginated results. The API may return more results than per_page when fewer than per_page results exist for the filter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `format` | string | No | Scoring format: 'sf' for Superflex or '1qb' for 1QB. |
| `league_size` | integer | No | Number of teams in league (8-16). Adjusts positional scarcity. |
| `max_age` | number | No | Maximum player age filter (e.g. 30). |
| `min_age` | number | No | Minimum player age filter (e.g. 21). |
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of players per page (1-100). |
| `position` | string | No | Filter by position. 'all' returns all positions. |
| `search` | string | No | Search for a specific player name within the rankings results. |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rosteraudit-com-api-0df80132/get_dynasty_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"format":"<string>","league_size":"<integer>","max_age":"<number>","min_age":"<number>","page":"<integer>","per_page":"<integer>","position":"<string>","search":"<string>","sort":"<string>"}'
```

### get_trade_values

Get a lightweight lookup table of all dynasty player trade values. Returns a map of Sleeper ID to Superflex and 1QB values. Ideal for spreadsheets and batch lookups. One request returns all players.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `format_key` | string | No | Scoring format key (e.g. 'sf_ppr', '1qb_ppr'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rosteraudit-com-api-0df80132/get_trade_values \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"format_key":"<string>"}'
```

### search_players

Search for dynasty-relevant players by name. Returns matching players with their dynasty values in both Superflex and 1QB formats, position rankings, team, age, and recent value trends. When q is omitted, returns top players by value.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `format_key` | string | No | Scoring format key (e.g. 'sf_ppr', '1qb_ppr'). |
| `limit` | integer | No | Number of results to return (1-20). |
| `position` | string | No | Filter results to a single position. |
| `q` | string | No | Player name to search for. Omit to get top players by value. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rosteraudit-com-api-0df80132/search_players \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"format_key":"<string>","limit":"<integer>","position":"<string>","q":"<string>"}'
```