# Oddschecker — 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 betting odds across multiple bookmakers for a wide range of sports, markets, and events on Oddschecker. Retrieve match details, race cards, market outcomes, and bookmaker-by-bookmaker odds to identify the best available prices.

**Category:** Sports | **Website:** [oddschecker.com/](https://oddschecker.com/) | **Docs:** [parse.bot/marketplace/fc1ba91c-bf55-4f2d-be14-3ad0d9deb989/oddschecker-com-api](https://parse.bot/marketplace/fc1ba91c-bf55-4f2d-be14-3ad0d9deb989/oddschecker-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-oddschecker-com-api-fc1ba91c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_football_leagues

Retrieves all football leagues and competitions listed on Oddschecker's football section. Returns league names and slugs that can be passed to get_football_matches as the league_path parameter.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddschecker-com-api-fc1ba91c/get_football_leagues \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_football_matches

Retrieves upcoming football matches for a given league. Returns match event names and slugs. The slug can be passed to get_match_odds. Results depend on the current schedule; off-season leagues return an empty list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `league_path` | string | No | Path to the league page on Oddschecker, e.g. 'football/english/premier-league', 'football/world-cup', 'football/champions-league'. Use slugs from get_football_leagues. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddschecker-com-api-fc1ba91c/get_football_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"league_path":"<string>"}'
```

### get_horse_race_odds

Retrieves odds comparison for a specific horse race. Returns all runners (horses) with their fractional odds from each bookmaker. Requires a race URL from get_horse_racing_meetings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `race_url` | string | Yes | Full URL of the race card from get_horse_racing_meetings results, e.g. 'https://www.oddschecker.com/horse-racing/yarmouth/14:10/winner'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddschecker-com-api-fc1ba91c/get_horse_race_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"race_url":"<string>"}'
```

### get_horse_racing_meetings

Retrieves today's horse racing meetings with venue names and scheduled race times. Each race includes a URL that can be passed to get_horse_race_odds. Availability depends on the racing calendar; non-race days return an empty list.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddschecker-com-api-fc1ba91c/get_horse_racing_meetings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_match_odds

Retrieves detailed odds comparison for a football match across all bookmakers. Returns one or more markets (e.g. Winner, Correct Score) each containing outcomes with fractional odds per bookmaker code, plus bookmaker metadata. Requires a match slug from get_football_matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_slug` | string | Yes | Match slug from get_football_matches results, e.g. 'football/world-cup/mexico-v-south-africa/winner'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddschecker-com-api-fc1ba91c/get_match_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"match_slug":"<string>"}'
```

### get_race_odds

Retrieves detailed odds comparison for a specific motorsport betting market across all bookmakers. Returns all runners/outcomes with their fractional odds from each bookmaker, plus bookmaker metadata. Use market slugs from get_sport_events. Works for race winner, podium finish, fastest qualifier, fastest lap, constructors and drivers championship markets.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `market_slug` | string | Yes | Market slug from get_sport_events results, e.g. 'motorsport/formula-1/dutch-grand-prix/winner', 'motorsport/formula-1/dutch-grand-prix/podium-finish'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddschecker-com-api-fc1ba91c/get_race_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"market_slug":"<string>"}'
```

### get_sport_events

Retrieves all available betting markets for a given motorsport category (e.g. Formula 1, MotoGP). Returns market names and slugs that can be passed to get_race_odds. Markets include race winner, podium finish, fastest qualifier, constructors/drivers championship, and more depending on the current schedule.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sport_path` | string | No | Path to the sport/category page on Oddschecker, e.g. 'motorsport/formula-1', 'motorsport/motogp', 'motorsport/nascar'. Use slugs from get_sports_list or the motorsport sub-categories. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddschecker-com-api-fc1ba91c/get_sport_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sport_path":"<string>"}'
```

### get_sports_list

Retrieves all sports available on Oddschecker. Returns sport names and slugs extracted from the site navigation. The slug can be used to construct league or event URLs for further exploration.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddschecker-com-api-fc1ba91c/get_sports_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_events

Full-text search across all sports on Oddschecker. Matches team names, competition names, and event titles. Returns event results with market details including market_map slugs, category, and timing information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search term, e.g. a team name, competition name, or event name. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oddschecker-com-api-fc1ba91c/search_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```