# Superbet — 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 sports betting data from Superbet.ro, including the full sports and competition hierarchy, pre-match and live event listings, detailed odds, boosted prices, popular accumulator suggestions, and Bet Builder markets.

**Category:** Sports | **Website:** [superbet.ro/](https://superbet.ro/) | **Docs:** [parse.bot/marketplace/ae116495-1a2f-4505-9dcb-9444606f2a76/superbet-ro-api](https://parse.bot/marketplace/ae116495-1a2f-4505-9dcb-9444606f2a76/superbet-ro-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-superbet-ro-api-ae116495/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_bet_builder_markets

Get available Bet Builder markets for a specific event. Returns structured markets with individual odds that can be combined into custom bets. Not all events support Bet Builder; football events typically have the most options.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Event ID from event listings (e.g. from get_sport_events or get_top_events results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-superbet-ro-api-ae116495/get_bet_builder_markets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### get_event_odds

Get all betting markets and odds for a specific event. Returns the full event detail including all available market lines and their current prices. The event_id can be obtained from get_sport_events, get_live_events, or get_top_events.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Event ID from event listings (e.g. from get_sport_events or get_top_events results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-superbet-ro-api-ae116495/get_event_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### get_live_events

Get currently live in-play betting events. Automatically queries a 12-hour window centered on the current time with offer state set to live. Returns events with real-time metadata including scores and period information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sport_id` | integer | No | Optional sport ID filter from list_sports. Omitting returns live events across all sports. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-superbet-ro-api-ae116495/get_live_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sport_id":"<integer>"}'
```

### get_popular_superbets

Get popular pre-built SuperBets (accumulator suggestions). Data is typically available for today and recent past dates; future dates return an empty array. Each entry includes the match details and suggested combination odds.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date for bets in format YYYY-MM-DD. Omitting defaults to today (UTC). Data is available for today and recent past dates. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-superbet-ro-api-ae116495/get_popular_superbets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>"}'
```

### get_sport_competitions

Get the full sports/competitions hierarchy including sports, categories, tournaments, outcomes, and market tree structure. Returns the complete navigation tree for all sports offered.

**Estimated cost:** Metered

_No parameters required._

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

### get_sport_events

Get upcoming or scheduled events for a sport and date range. Returns event objects with pre-selected odds. When no dates are provided, defaults to today through tomorrow. Supports filtering by sport ID and offer state (pre-match or live).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_date` | string | No | End date/time in format YYYY-MM-DD HH:mm:ss. Omitting defaults to tomorrow at 23:59:59 UTC. |
| `offer_state` | string | No | Event state filter. |
| `sport_id` | integer | No | Sport ID from list_sports (e.g. 5 for Fotbal, 2 for Tenis). Omitting returns events across all sports. |
| `start_date` | string | No | Start date/time in format YYYY-MM-DD HH:mm:ss. Omitting defaults to today at 00:00:00 UTC. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-superbet-ro-api-ae116495/get_sport_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"end_date":"<string>","offer_state":"<string>","sport_id":"<integer>","start_date":"<string>"}'
```

### get_super_boost_odds

Get events with boosted odds (Super Boost/Cote Marite). Boosted odds are typically available for today and tomorrow only; dates further out return an empty array. Each event includes both original and boosted prices.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date for boosts in format YYYY-MM-DD. Omitting defaults to today (UTC). Only today and tomorrow typically have boosted odds available. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-superbet-ro-api-ae116495/get_super_boost_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>"}'
```

### get_top_events

Get IDs of featured/top events curated by Superbet. Returns a configuration object with a topMatches array of event IDs that can be used with get_event_odds to retrieve full details.

**Estimated cost:** Metered

_No parameters required._

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

### list_sports

List all available sports with their IDs, names, and icons. Returns the full catalog of sports offered on Superbet.ro, ordered by display priority.

**Estimated cost:** Metered

_No parameters required._

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