# Snai — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-snai-it-api-59e4b38c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-snai-it-api-59e4b38c/get_football_leagues \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-snai-it-api-59e4b38c/get_live_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-snai-it-api-59e4b38c/get_match_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-snai-it-api-59e4b38c/get_match_url \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-snai-it-api-59e4b38c/get_serie_a_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-snai-it-api-59e4b38c/get_serie_a_top_bets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```