# Oddsjam — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-oddsjam-com-api-5cad6e29/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-oddsjam-com-api-5cad6e29/get_game_odds_by_market \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-oddsjam-com-api-5cad6e29/get_mlb_futures_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-oddsjam-com-api-5cad6e29/get_mlb_game_moneyline_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-oddsjam-com-api-5cad6e29/get_mlb_games_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-oddsjam-com-api-5cad6e29/get_mlb_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-oddsjam-com-api-5cad6e29/get_mlb_screen_market \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-oddsjam-com-api-5cad6e29/get_mlb_team_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-oddsjam-com-api-5cad6e29/get_mlb_teams \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```