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

> Monitor betting odds and sports markets from LVBet.pl by browsing available sports categories, viewing upcoming matches, and accessing detailed odds across different betting markets. Get real-time odds data to compare betting options and track market movements for your preferred sports events.

**Category:** Sports | **Website:** [lvbet.pl/en/pre-matches/e-football/europe/--/78674/79382/](https://lvbet.pl/en/pre-matches/e-football/europe/--/78674/79382/) | **Docs:** [parse.bot/marketplace/76b9a9d0-46fc-47a3-b355-d5e2494b34e8/lvbet-pl-api](https://parse.bot/marketplace/76b9a9d0-46fc-47a3-b355-d5e2494b34e8/lvbet-pl-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-lvbet-pl-api-76b9a9d0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_match_odds

Get all available betting markets and odds for a specific match. Returns the full set of market details including match result, totals, handicaps, half-time markets, team-specific markets, and all other available betting options. Each market contains selections with decimal, american, and fractional odds formats. Markets are grouped by category (e.g. Handicap, Half, Team 1, Team 2).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language code for labels. |
| `match_id` | string | Yes | Match identifier (e.g. 'bp:552720'). Obtain from get_matches endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lvbet-pl-api-76b9a9d0/get_match_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>","match_id":"<string>"}'
```

### get_matches

Get pre-match listings with primary market odds for a given sports group. Returns all upcoming matches in the competition along with their primary column markets (match result, total goals, first goal scorer) and selections with decimal/american/fractional odds. Each match includes team names, scheduled date, and market availability count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language code for labels. |
| `sports_group_id` | string | Yes | Sports group ID for the competition to fetch matches from (e.g. '79382' for E-Football Europe). Obtain from list_sports_groups endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lvbet-pl-api-76b9a9d0/get_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>","sports_group_id":"<string>"}'
```

### list_sports_groups

List sports groups (sports, regions, competitions) in LVBet's hierarchy. Use parent_id=null to get top-level sports, then use a sports_group_id as parent_id to drill into sub-categories (e.g. Football → England → Premier League). Returns all children of the specified parent along with prematch/live event counts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language code for labels. |
| `parent_id` | string | No | Parent sports group ID to list children of. Use 'null' for top-level sports categories, or a numeric ID like '78674' to get sub-groups. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lvbet-pl-api-76b9a9d0/list_sports_groups \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>","parent_id":"<string>"}'
```