# Oddsjam — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 and upcoming MLB game odds across multiple sportsbooks, along with detailed moneyline information, schedules, and futures betting data. Compare odds by market, view team-specific odds, and stay updated on all available betting options for MLB games.

**Category:** Sports | **Website:** [oddsjam.com/](https://oddsjam.com/) | **Docs:** [parse.bot/marketplace/5cad6e29-2a97-4a0c-a211-a2443d2e383b/oddsjam-com-api](https://parse.bot/marketplace/5cad6e29-2a97-4a0c-a211-a2443d2e383b/oddsjam-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/oddsjam/`
**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 odds by market

Fetch odds for the moneyline market for a given MLB game across all sportsbooks. Returns detailed odds from each book including American-format prices, liquidity, and timestamps. Similar to get_mlb_game_moneyline_detail but returns only the odds array without root_info metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_id` | string | Yes | The unique identifier for the game, obtained from get_mlb_games_odds events[*].id. |
| `market_name` | string | No | The market name. |
| `state` | string | No | Two-letter US state code for regional odds availability. |

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

### Get mlb futures odds

Fetch MLB futures markets and odds. Without future_id, returns a list of available futures markets (World Series Winner, MVP, division winners, etc.). With future_id, returns the market with nested odds from each sportsbook.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `future_id` | string | No | The unique identifier for the futures market, obtained from this endpoint's data[*].id when called without future_id. If omitted, returns a list of available markets. |
| `state` | string | No | Two-letter US state code for regional odds availability. |

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

### Get mlb game moneyline detail

Fetch detailed moneyline odds for a specific MLB game across all available sportsbooks. Returns individual odds from each book with American-format prices, timestamps, and liquidity data where available. The root_info object provides game metadata including teams and start time.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_id` | string | Yes | The unique identifier for the game, obtained from get_mlb_games_odds events[*].id. |
| `state` | string | No | Two-letter US state code for regional odds availability. |

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

### Get mlb games odds

Fetch upcoming and live MLB games with best moneyline odds, team names, and start times. Each event includes best odds across sportsbooks for moneyline, spread, and total markets. Paginates via integer page counter. Results include both live in-progress games and upcoming scheduled games.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `state` | string | No | Two-letter US state code for regional odds availability (e.g. 'NY', 'UT', 'NJ'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/oddsjam/get-mlb-games-odds \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","state":"<string>"}'
```

### Get mlb schedule

Fetch the full MLB schedule including matchup names, start times, venues, and starting pitchers. Each game includes broadcast info, season metadata, and a game_id that can be used with odds endpoints. Paginates via integer page counter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `team` | string | No | Filter by team name or 'All' for all teams. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/oddsjam/get-mlb-schedule \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","team":"<string>"}'
```

### Get mlb screen market

Fetch the sportsbook odds screen for the MLB moneyline market. Returns a grid of all current games with their odds across every available sportsbook, plus the list of sportsbook names. Useful for cross-book comparison views.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `market_name` | string | No | The market name. |
| `state` | string | No | Two-letter US state code for regional odds availability. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/oddsjam/get-mlb-screen-market \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"market_name":"<string>","state":"<string>"}'
```

### Get mlb team odds

Fetch detailed information for a specific MLB team including full roster, injuries, team stats (ATS records, win/loss records), and upcoming schedule. Team slugs are lowercase hyphenated team names.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_slug` | string | Yes | The team slug in lowercase hyphenated format (e.g. 'arizona-diamondbacks', 'new-york-yankees', 'los-angeles-dodgers'). |

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

### Get mlb teams

Fetch all MLB teams organized by league and division. Returns team names, abbreviations, conference (AL/NL), division, and logo URLs. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

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

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.