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

> Access today's top sports betting opportunities from Betway Mozambique by viewing highlighted games sorted by lowest odds, browsing available leagues, and tracking live in-play events with real-time scores. Stay informed on favorites and current matchups to make informed betting decisions across multiple sports leagues.

**Category:** Sports | **Website:** [www.betway.co.mz/](https://www.betway.co.mz/) | **Docs:** [parse.bot/marketplace/1b686c68-c94a-4587-91de-921cd0b6f68d/betway-co-mz-api](https://parse.bot/marketplace/1b686c68-c94a-4587-91de-921cd0b6f68d/betway-co-mz-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/betway/`
**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 highlights

Retrieve today's highlighted/upcoming sports events with 1X2 odds (Win/Draw/Win), Double Chance, and Both Teams To Score markets. Results can be sorted by lowest odds to identify favorites most likely to win. Each event includes home/away team names, league, start time, and decimal odds.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | No | ISO country code for the Betway region (e.g. MZ for Mozambique). |
| `culture_code` | string | No | Locale/culture code for response language (e.g. pt-MZ for Portuguese-Mozambique). |
| `league_id` | string | No | Filter by specific league ID (e.g. fifa-world-cup, premier-league). Obtainable from get_leagues endpoint. |
| `skip` | string | No | Number of events to skip for pagination. |
| `sort_by_lowest_odds` | string | No | When true, results are sorted by lowest odds first (strongest favorites). When false, results are in chronological order. |
| `sport_id` | string | No | Sport identifier. Accepted values: soccer, tennis, cricket, basketball, rugby-union, table-tennis, baseball, ice-hockey, handball, american-football, volleyball, boxing, ufc---martial-arts, darts, badminton, futsal. |
| `take` | string | No | Maximum number of events to return per request. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/betway/get-highlights \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"<string>","culture_code":"<string>","league_id":"<string>","skip":"<string>","sort_by_lowest_odds":"<string>","sport_id":"<string>","take":"<string>"}'
```

### Get leagues

Retrieve all available regions and leagues for a given sport. Returns a flat list of league entries with their region context. Use league_id values from this endpoint to filter get_highlights results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | No | ISO country code for the Betway region (e.g. MZ for Mozambique). |
| `sport_id` | string | No | Sport identifier. Accepted values: soccer, tennis, cricket, basketball, rugby-union, table-tennis, baseball, ice-hockey, handball, american-football, volleyball, boxing, ufc---martial-arts, darts, badminton, futsal. |

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

### Get live events

Retrieve currently live in-play sports events with real-time scores and 1X2 odds. Returns events that are actively being played with their current score state. May return empty results when no live events are available for the requested sport.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | No | ISO country code for the Betway region (e.g. MZ for Mozambique). |
| `culture_code` | string | No | Locale/culture code for response language (e.g. pt-MZ for Portuguese-Mozambique). |
| `skip` | string | No | Number of events to skip for pagination. |
| `sport_id` | string | No | Sport identifier. Accepted values: soccer, tennis, cricket, basketball, rugby-union, table-tennis, baseball, ice-hockey, handball, american-football, volleyball, boxing, ufc---martial-arts, darts, badminton, futsal. |
| `take` | string | No | Maximum number of events to return per request. |

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

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