# Interwetten — 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 real-time basketball betting odds, matches, and market information from Interwetten across all major leagues including NBA, NCAA, and Euroleague. Browse available leagues, view upcoming matches, and get detailed betting details for 35+ basketball competitions worldwide.

**Category:** Sports | **Website:** [interwetten.com/](https://interwetten.com/) | **Docs:** [parse.bot/marketplace/ef55527b-6589-41a7-9cdd-775ec38400a8/interwetten-com-api](https://parse.bot/marketplace/ef55527b-6589-41a7-9cdd-775ec38400a8/interwetten-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/interwetten/`
**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 leagues

Retrieves all basketball leagues currently offered on Interwetten with their IDs, names, and URLs. The list reflects whatever competitions have active or upcoming events. No parameters needed — returns the full catalog in one call.

**Estimated cost:** Metered

_No parameters required._

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

### Get match details

Retrieves all betting markets and outcomes for a specific match organized into named groups (Main bets, Handicap, Over/Under, Quarter bets, Halftime, Team Points, Player Specials, Special bets). Returns the full depth of available markets — typically 50-200 markets with 2-40+ outcomes each depending on the event's profile. Requires event_id from get_matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | The event/match ID obtained from the get_matches endpoint (e.g. '18756011'). |
| `slug` | string | No | URL slug for the match (e.g. 'new-york-knicks-san-antonio-spurs'). Optional — the site resolves the event by ID alone. |

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

### Get matches

Fetches basketball matches with summary betting odds (Match winner and Handicap markets). By default queries all known basketball leagues; pass league_ids to narrow to specific competitions. Each event includes home/away teams, date, live status, and the top-level market odds. For full market depth use get_match_details with the returned event_id.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `league_ids` | string | No | Comma-separated league IDs to filter (e.g. '15103' for NBA only, '15103,412221' for NBA and BNXT League). League IDs are obtained from the get_leagues endpoint. Omitting returns all basketball leagues. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/interwetten/get-matches \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"league_ids":"<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.