# Snai — 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 real-time Serie A match information, odds, and top betting opportunities directly from SNAI.it, plus discover live matches and football leagues to inform your betting decisions. Access match details, current odds, and curated top bets all in one place to stay updated on Italian football betting options.

**Category:** Sports | **Website:** [snai.it/](https://snai.it/) | **Docs:** [parse.bot/marketplace/59e4b38c-f16b-4848-a8fc-245fc083a3a3/snai-it-api](https://parse.bot/marketplace/59e4b38c-f16b-4848-a8fc-245fc083a3a3/snai-it-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/snai/`
**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 football leagues

Returns the full list of available football competitions and leagues from the SNAI prematch tree. Includes league name, internal key, country icon URL, and whether the league is marked as a top/featured competition.

**Estimated cost:** Metered

_No parameters required._

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

### Get live matches

Returns currently live sports categories with event counts. Shows which sports have active live events and how many are in each category. Categories include Calcio (football), Basket, Tennis, and others depending on what is live.

**Estimated cost:** Metered

_No parameters required._

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

### Get match odds

Returns all available betting markets and odds for a specific match/event. The match_slug is the key field from get_serie_a_matches results (format: palinsesto_code-avvenimento_code). Returns the full set of markets with all selections and decimal odds.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_slug` | string | Yes | Match key in format 'palinsesto-avvenimento' (e.g. '37211-165'). Obtained from get_serie_a_matches results.items[*].key. |

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

### Get match url

Finds the match key and URL for a given home and away team in the current Serie A schedule. Uses partial case-insensitive matching.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `away_team` | string | Yes | Away team name (partial, case-insensitive match). |
| `home_team` | string | Yes | Home team name (partial, case-insensitive match). |

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

### Get serie a matches

Returns all upcoming Serie A events for the current/next matchday. During the season these are individual match fixtures with home/away teams; during off-season they may be antepost (outright winner) markets only. Optionally includes top odds for each event.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `include_odds` | boolean | No | Whether to include top odds (e.g. 1X2, outright winner) for each event. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/snai/get-serie-a-matches \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"include_odds":"<boolean>"}'
```

### Get serie a top bets

Returns upcoming Serie A events with their betting odds included. Each event includes a top_odds array of markets with selections and decimal odds values.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/snai/get-serie-a-top-bets \
  -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.