# Virgin Bet — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.

> Get live betting odds for sports and esports events from Virgin Bet, including main market odds and detailed breakdowns for each event. Browse available sports, search specific events, and access comprehensive odds data to compare betting options across different markets.

**Category:** Sports | **Website:** [www.virginbet.com/](https://www.virginbet.com/) | **Docs:** [parse.bot/marketplace/8bd2f1c0-23cd-4466-af87-a8e6594a10e1/virginbet-com-api](https://parse.bot/marketplace/8bd2f1c0-23cd-4466-af87-a8e6594a10e1/virginbet-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/virgin-bet/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get event odds

Get detailed odds and all available markets for a specific event. Returns full market breakdowns including Full Time result, Both Teams To Score, Total Goals, Double Chance, Draw No Bet, and more. Each market contains selections with decimal and fractional odds, outcome types, and handicap values. Event IDs are obtained from get_sport_events. Requires a valid, currently-listed event_id; expired or invalid IDs return input_not_found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Event ID from get_sport_events results (e.g. SBTE_2_1027919958). |
| `sport_id` | string | No | Sport category ID the event belongs to. Helps narrow the search. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/virgin-bet/get-event-odds \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>","sport_id":"<string>"}'
```

### Get sport events

Get upcoming and live events with main market odds for a given sport. Returns events with home/away teams, competition names, start times, state (INPLAY/NOTSTARTED), and 1X2 odds where available. Events are sourced from the sport's home page coupons. Use sport IDs from list_sports endpoint. A single request returns all featured events for the sport without pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sport_id` | string | No | Sport category ID from list_sports. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/virgin-bet/get-sport-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"sport_id":"<string>"}'
```

### List sports

List all available sports and esports categories with live and upcoming event counts. Returns both traditional sports (Football, Tennis, Basketball) and esports (E-Sports, Esports Football, Esports Basketball). Each sport includes its ID for use in get_sport_events, counters for in-play and upcoming events, and navigation metadata. The full list is returned in a single response with no pagination.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/virgin-bet/list-sports \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.