# Prizepicks — 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 player prop projections and betting lines from PrizePicks across multiple sports leagues. Filter by league, US state, and live status to retrieve current lines, opening lines, player profiles, game metadata, and trending props.

**Category:** Sports | **Website:** [prizepicks.com/](https://prizepicks.com/) | **Docs:** [parse.bot/marketplace/6c00747c-a4fd-4e24-a949-016f887ff9e3/prizepicks-com-api](https://parse.bot/marketplace/6c00747c-a4fd-4e24-a949-016f887ff9e3/prizepicks-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-prizepicks-com-api-6c00747c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_games

Fetch game/match data including start times, status, live scores, and team metadata. Returns up to 250 games per request. Game metadata includes team abbreviations, scores for in-progress games, and period/inning details. Status values include 'scheduled', 'in-progress', and 'completed'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `league_id` | integer | No | Filter by league ID. Omitting returns games across all leagues. Common values: 7 (NBA), 8 (NHL), 2 (MLB). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prizepicks-com-api-6c00747c/get_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"league_id":"<integer>"}'
```

### get_leagues

Fetch available sports leagues and their metadata including active status, projections count, and display information. Each league has a unique ID used as a filter across other endpoints. The projections_count field reflects current availability and changes throughout the day as lines open and close.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `state_code` | string | No | US state code for geo-filtering available leagues. Different states may have different league availability due to regulations. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prizepicks-com-api-6c00747c/get_leagues \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state_code":"<string>"}'
```

### get_players

Fetch player profiles and roster data. Returns up to 250 players per request. Includes player name, position, team, league affiliation, and headshot image URL. Use league_id to scope results to a single sport.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `league_id` | integer | No | Filter by league ID. Omitting returns players across all leagues. Common values: 7 (NBA), 8 (NHL), 2 (MLB), 3 (WNBA), 9 (NFL). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prizepicks-com-api-6c00747c/get_players \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"league_id":"<integer>"}'
```

### get_projections

Fetch real-time player prop projections with resolved relationships to players, games, leagues, and stat types. Returns opening lines (board_time), current lines (line_score), odds type, and game context. Supports pagination and filtering by league, state, and live status. A league_id filter is recommended to avoid excessively large responses.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `is_live` | boolean | No | Filter for live/in-game props only. Omitting returns all props. |
| `league_id` | integer | No | Filter by league ID. Strongly recommended to avoid multi-MB responses. Common values: 7 (NBA), 8 (NHL), 2 (MLB), 3 (WNBA). |
| `per_page` | integer | No | Number of results per page. Maximum 250. |
| `single_stat` | boolean | No | Filter for single stat props. |
| `state_code` | string | No | US state code for geo-filtering available lines. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prizepicks-com-api-6c00747c/get_projections \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"is_live":"<boolean>","league_id":"<integer>","per_page":"<integer>","single_stat":"<boolean>","state_code":"<string>"}'
```

### get_trending

Fetch trending projection IDs and their popularity scores for a specific league. Returns a mapping of projection_id to score where higher scores indicate more user activity. Use alongside get_projections to resolve the trending IDs into full projection details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `league_id` | integer | Yes | League ID to fetch trending data for. Common values: 7 (NBA), 8 (NHL), 2 (MLB), 3 (WNBA). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-prizepicks-com-api-6c00747c/get_trending \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"league_id":"<integer>"}'
```