> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Mercati & linee

> moneyline, handicap, totals, team totals — per periodo, con alt‑lines.

Ogni linea di quota è identificata da **(`period`, `market`, `line`)** e riporta un `line_id` intero stabile.

## Tipi di mercato

| `market`                      | Descrizione       | Colonne di quote                                       |
| ----------------------------- | ----------------- | ------------------------------------------------------ |
| `moneyline`                   | 1X2 / vincitore   | `odds1` (home), `odds0` (draw), `odds2` (away)         |
| `spread`                      | Handicap asiatico | `odds1` (home), `odds2` (away), `line` = handicap casa |
| `totals`                      | Over / Under      | `odds1` (over), `odds2` (under), `line` = total        |
| `home_totals` / `away_totals` | Total per squadra | `odds1` (over), `odds2` (under)                        |

Per i mercati 2‑way (spread/totals), `odds0` è `null`.

## Periodi

`period = 0` = match completo. Gli altri periodi dipendono dallo sport (`1` = 1° tempo / set, ecc.). Recupera il catalogo tramite [`/api/periods`](/it/api-reference/introduction).

## Linee principali vs alt‑lines

Per impostazione predefinita, `/api/odds` restituisce **tutte** le linee (incluse le alternative). Aggiungi `main_lines_only=1` per mantenere solo la linea principale di ogni mercato (`alt_line_id` nullo).

```bash theme={null}
curl "https://api.apinn.io/api/odds?event_id=1608247913&main_lines_only=1" \
  -H "X-API-Key: TUA_CHIAVE"
```

## max\_win

`max_win` = puntata massima accettata (limite Pinnacle) sulla linea, indicatore di liquidità.