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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/rosteraudit/`
**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

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/credits/rosteraudit/get-dynasty-rankings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/rosteraudit/get-trade-values \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/rosteraudit/search-players \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"format_key":"<string>","limit":"<integer>","position":"<string>","q":"<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.