> ## 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.

# Mercados e linhas

> moneyline, handicap, totals, team totals — por período, com alt-lines.

Cada linha de odds é identificada por **(`period`, `market`, `line`)** e tem um `line_id` inteiro estável.

## Tipos de mercado

| `market`                      | Descrição         | Colunas de odds                                        |
| ----------------------------- | ----------------- | ------------------------------------------------------ |
| `moneyline`                   | 1X2 / vencedor    | `odds1` (home), `odds0` (draw), `odds2` (away)         |
| `spread`                      | Handicap asiático | `odds1` (home), `odds2` (away), `line` = handicap casa |
| `totals`                      | Over / Under      | `odds1` (over), `odds2` (under), `line` = total        |
| `home_totals` / `away_totals` | Total por equipa  | `odds1` (over), `odds2` (under)                        |

Para os mercados 2-way (spread/totals), `odds0` é `null`.

## Períodos

`period = 0` = jogo completo. Os outros períodos dependem do desporto (`1` = 1.ª parte / set, etc.). Obtenha o catálogo através de [`/api/periods`](/pt/api-reference/introduction).

## Linhas principais vs alt-lines

Por defeito, `/api/odds` devolve **todas** as linhas (incluindo as alternativas). Adicione `main_lines_only=1` para manter apenas a linha principal de cada mercado (`alt_line_id` nulo).

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

## max\_win

`max_win` = aposta máxima aceite (limite Pinnacle) na linha, indicador de liquidez.
