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

> Find profitable betting opportunities and compare real-time odds across dozens of bookmakers to identify sure bets, value bets, and dropping odds for various sports. Filter matches by sport, league, and region to make informed betting decisions with comprehensive odds comparisons and match information.

**Category:** Sports | **Website:** [oddspedia.com/](https://oddspedia.com/) | **Docs:** [parse.bot/marketplace/78945e11-6e5c-49d2-9bdc-e6b43e3e4e48/oddspedia-com-api](https://parse.bot/marketplace/78945e11-6e5c-49d2-9bdc-e6b43e3e4e48/oddspedia-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-oddspedia-com-api-78945e11/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_bookmakers_list

List all bookmakers tracked by Oddspedia with ratings, affiliate info, and brand colors.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `geo_code` | string | No | Two-letter country code for geo-targeted results. Omitting returns all bookmakers. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddspedia-com-api-78945e11/get_bookmakers_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"geo_code":"<string>"}'
```

### get_dropping_odds

Track significant odds movements (dropping odds) over a specified time period. Returns matches where odds have dropped by the specified percentage range. Paginated with 25 results per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `drop_range` | string | No | Min,max drop percentage range as two comma-separated decimal values. |
| `page` | integer | No | Page number for pagination. |
| `period` | string | No | Time period for drop monitoring. Accepted value: '1day'. |
| `sports` | string | No | Comma-separated sport IDs to filter by. Omitting returns all sports. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddspedia-com-api-78945e11/get_dropping_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"drop_range":"<string>","page":"<integer>","period":"<string>","sports":"<string>"}'
```

### get_hot_bets

Retrieve statistically trending bets based on team form and historical hit rates. Returns bets where both home and away teams meet the minimum success percentage for the selected market.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `markets_json` | string | No | JSON string of market filters. Keys are market IDs, values are objects mapping handicap values to outcome codes (e.g. 'o1' for over, 'o2' for under). |
| `min_percent` | integer | No | Minimum combined hit percentage (51-100). |
| `period` | string | No | Time period filter. Accepted value: 'next_24_hours'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddspedia-com-api-78945e11/get_hot_bets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"markets_json":"<string>","min_percent":"<integer>","period":"<string>"}'
```

### get_leagues_by_sport

List available leagues and competitions for a given sport. Returns league name, slug, category, match counts, and ordering. Can filter to show only top/popular leagues.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sport` | string | No | Sport slug (e.g. 'football', 'basketball', 'ice-hockey', 'tennis'). |
| `top_only` | string | No | Set to '1' to return only top leagues, '0' for all leagues. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddspedia-com-api-78945e11/get_leagues_by_sport \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sport":"<string>","top_only":"<string>"}'
```

### get_match_info

Get detailed metadata for a specific match including venue, team form, scores, season info, league details, and SEO template. Returns comprehensive match context useful for pre-match analysis.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_key` | string | Yes | Unique match identifier (match_key field from get_surebets, get_dropping_odds, get_value_bets, get_matches_by_sport, or get_hot_bets results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddspedia-com-api-78945e11/get_match_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"match_key":"<string>"}'
```

### get_matches_by_sport

List upcoming and live matches for a specific sport with current max odds from all bookmakers. Returns matches for today by default. Each match includes its best odds from various bookmakers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_date` | string | No | End date in ISO format (e.g. '2026-06-10T23:59:59Z'). Defaults to end of today UTC. |
| `sport` | string | No | Sport slug (e.g. 'football', 'basketball', 'ice-hockey', 'tennis', 'volleyball'). |
| `start_date` | string | No | Start date in ISO format (e.g. '2026-06-10T00:00:00Z'). Defaults to start of today UTC. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddspedia-com-api-78945e11/get_matches_by_sport \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"end_date":"<string>","sport":"<string>","start_date":"<string>"}'
```

### get_odds_comparison

Get full odds comparison across all bookmakers for a specific match and betting market group. Returns odds organized by period with each bookmaker's odds, payout percentages, bonus info, and odds movement direction.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `market_group_id` | string | No | Market group ID: '2' for Home/Away, '3' for Asian Handicap, '4' for Over/Under. |
| `match_key` | string | Yes | Unique match identifier (match_key field from get_surebets, get_dropping_odds, get_value_bets, or get_hot_bets results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddspedia-com-api-78945e11/get_odds_comparison \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"market_group_id":"<string>","match_key":"<string>"}'
```

### get_sports_list

List all sports currently tracked on Oddspedia with sure bet event counts for each sport.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `language` | string | No | Language code for response content. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddspedia-com-api-78945e11/get_sports_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language":"<string>"}'
```

### get_surebets

Extract arbitrage betting opportunities (sure bets) across bookmakers. Returns matches where combined odds across outcomes guarantee profit, sorted by profit percentage. Each surebet includes match details, league, sport, market type, and best odds from different bookmakers for each outcome.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bookmakers` | string | No | Comma-separated bookmaker IDs to filter by. Omitting returns all bookmakers. |
| `geo_code` | string | No | Two-letter country code for geo-targeted odds (e.g. 'US', 'GB'). Omitting returns global odds. |
| `language` | string | No | Language code for response content. |
| `profit_range` | string | No | Min,max profit percentage range as two comma-separated decimal values. |
| `sports` | string | No | Comma-separated sport IDs to filter by (e.g. '1' for Football, '2' for Ice Hockey, '3' for Basketball). Omitting returns all sports. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddspedia-com-api-78945e11/get_surebets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bookmakers":"<string>","geo_code":"<string>","language":"<string>","profit_range":"<string>","sports":"<string>"}'
```

### get_value_bets

Extract mathematically overvalued odds (value bets) across sports and bookmakers. Returns bets where bookmaker odds significantly exceed calculated fair probability, sorted by overvalue percentage.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `odds_max` | string | No | Maximum odds value as decimal string. |
| `odds_min` | string | No | Minimum odds value as decimal string. |
| `overvalue_range` | string | No | Min,max overvalue percentage range as two comma-separated decimal values. |
| `sports` | string | No | Comma-separated sport IDs to filter by. Omitting returns all sports. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddspedia-com-api-78945e11/get_value_bets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"odds_max":"<string>","odds_min":"<string>","overvalue_range":"<string>","sports":"<string>"}'
```