# Stake — 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 and detailed betting odds across popular sports fixtures from Stake.com, with the ability to search current odds by sport or dive into specific fixture market data. Monitor real-time odds movements to stay updated on the latest betting lines for your favorite sports events.

**Category:** Sports | **Website:** [stake.com/](https://stake.com/) | **Docs:** [parse.bot/marketplace/b2b2d707-a580-491a-a11a-aeb805b54de9/stake-com-api](https://parse.bot/marketplace/b2b2d707-a580-491a-a11a-aeb805b54de9/stake-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/stake/`
**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 fixture odds

Get all available market odds for a specific fixture/match. Returns detailed odds across market groups (1x2, over/under, handicap, etc.) along with fixture metadata, live scores when applicable, and all available market group names for further queries.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fixture` | string | Yes | Fixture slug from fixture listings (e.g. '46081991-mexico-south-africa'). |
| `group` | string | No | Market group to fetch. |

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

### Get live odds

Get live or upcoming fixtures with odds for a specific sport, organized by tournament. Returns fixtures with real-time scores for live matches. Each fixture includes competitors, current score, match time, period scores, and market outcomes with decimal odds.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fixture_limit` | integer | No | Maximum fixtures per tournament. |
| `group` | string | No | Market group. |
| `sport` | string | No | Sport slug. |
| `tournament_limit` | integer | No | Maximum number of tournaments to return. |
| `type` | string | No | Fixture type filter. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/stake/get-live-odds \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"fixture_limit":"<integer>","group":"<string>","sport":"<string>","tournament_limit":"<integer>","type":"<string>"}'
```

### Get sport odds

Get popular fixtures with odds for a specific sport. Returns the top tournament's fixtures with winner market odds, plus a list of all tournaments and categories for the sport. Each fixture includes competitors, start time, status, and market outcomes with decimal odds. The limit parameter caps the number of fixtures returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `group` | string | No | Market group to include. |
| `limit` | integer | No | Maximum number of fixtures to return. |
| `sport` | string | No | Sport slug. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/stake/get-sport-odds \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"group":"<string>","limit":"<integer>","sport":"<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.