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

# Markets & lines

> moneyline, handicap, totals, team totals — per period, with alt-lines.

Each odds line is identified by **(`period`, `market`, `line`)** and carries a stable integer `line_id`.

## Market types

| `market`                      | Description    | Odds columns                                           |
| ----------------------------- | -------------- | ------------------------------------------------------ |
| `moneyline`                   | 1X2 / winner   | `odds1` (home), `odds0` (draw), `odds2` (away)         |
| `spread`                      | Asian handicap | `odds1` (home), `odds2` (away), `line` = home handicap |
| `totals`                      | Over / Under   | `odds1` (over), `odds2` (under), `line` = total        |
| `home_totals` / `away_totals` | Per-team total | `odds1` (over), `odds2` (under)                        |

For 2-way markets (spread/totals), `odds0` is `null`.

## Periods

`period = 0` = full match. Other periods depend on the sport (`1` = first half / set, etc.). Fetch the catalog via [`/api/periods`](/en/api-reference/introduction).

## Main lines vs alt-lines

By default, `/api/odds` returns **all** lines (including alternatives). Add `main_lines_only=1` to keep only the main line of each market (null `alt_line_id`).

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

## max\_win

`max_win` = maximum accepted stake (Pinnacle limit) on the line, a liquidity indicator.