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

> Compare sportsbooks and their ratings, view real-time betting odds across sports and specific matchups, monitor how lines move over time, and discover expert picks and promotions all in one place. Make more informed betting decisions by accessing comprehensive sportsbook reviews, odds comparisons, and professional analysis.

**Category:** Sports | **Website:** [sportsbookreview.com/](https://sportsbookreview.com/) | **Docs:** [parse.bot/marketplace/0f65d708-57a2-40ad-83cb-61b5052fdb70/sportsbookreview-com-api](https://parse.bot/marketplace/0f65d708-57a2-40ad-83cb-61b5052fdb70/sportsbookreview-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/sportsbookreview/`
**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 game matchup odds

Get full matchup details for a specific game including consensus pick percentages, current odds across all sportsbooks for moneyline, spread, and totals, plus team statistics. The game_id comes from get_odds_by_sport games[].game_id.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_id` | string | Yes | Numeric game ID obtained from get_odds_by_sport games[].game_id |
| `sport` | string | Yes | Sport slug: 'mlb-baseball', 'nfl-football', 'nba-basketball', 'college-football', 'college-basketball', 'nhl-hockey' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/sportsbookreview/get-game-matchup-odds \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"game_id":"<string>","sport":"<string>"}'
```

### Get line history

Get complete line movement history for a specific game across sportsbooks, including timestamped moneyline, spread, and total history. Shows how odds have moved over time for each sportsbook. The game_id comes from get_odds_by_sport games[].game_id.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_id` | string | Yes | Numeric game ID obtained from get_odds_by_sport games[].game_id |
| `sport` | string | Yes | Sport slug: 'mlb-baseball', 'nfl-football', 'nba-basketball', 'college-football', 'college-basketball', 'nhl-hockey' |

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

### Get odds by sport

Get today's games with consensus betting percentages for a given sport. Returns game IDs (for use with get_game_matchup_odds and get_line_history), team names, start times, venues, and public consensus moneyline/total percentages. Use get_game_matchup_odds to drill into a specific game's full odds.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date in YYYY-MM-DD format. Omitting returns today's games. |
| `sport` | string | Yes | Sport slug: 'mlb-baseball', 'nfl-football', 'nba-basketball', 'college-football', 'college-basketball', 'nhl-hockey' |

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

### Get picks by sport

Get expert betting picks and analysis articles for a given sport. Returns article titles, links, and summaries from SBR's picks section. Note: uses shorter sport slugs without the league suffix.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sport` | string | Yes | Sport slug for picks: 'nfl', 'nba', 'mlb', 'nhl', 'college-football', 'college-basketball' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/sportsbookreview/get-picks-by-sport \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"sport":"<string>"}'
```

### Get promos by sportsbook

Get current promotional offers and promo codes for a specific sportsbook. Returns the bonus description headline, promo code (or 'No code required'), and the promo page URL. The name parameter is the sportsbook slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Sportsbook slug for promo page (e.g., 'fanduel', 'draftkings', 'betmgm', 'caesars', 'bet365') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/sportsbookreview/get-promos-by-sportsbook \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>"}'
```

### Get sportsbook list

Retrieve all reviewed sportsbooks with their names, slugs, and URLs. Returns the sportsbooks featured on the betting-sites page. Each entry's slug is the input key for get_sportsbook_review and get_promos_by_sportsbook.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/sportsbookreview/get-sportsbook-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get sportsbook review

Get detailed review information for a specific sportsbook including its overall rating, highlight bullet points, a text summary, and quick facts table. The name parameter is the sportsbook slug from get_sportsbook_list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Sportsbook slug as returned by get_sportsbook_list (e.g., 'fanduel', 'draftkings', 'betmgm-sportsbook', 'caesars', 'bet365') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/sportsbookreview/get-sportsbook-review \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"name":"<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.