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

# Specials & outrights

> Props, Torschützen und Turniersieger — Katalog und Quoten.

Die **Specials** decken Props ab (Torschützen, Kombis…) sowie die **outrights / futures** (Turniersieger, Top-Platzierung…).

## Katalog: `/api/specials/outrights`

Gibt eine Zeile pro **Markt × Contestant** zurück, mit den Metadaten (ohne Quoten):

```json theme={null}
{
  "sport_id": 29,
  "league_id": 2627,
  "special_id": 1631640230,
  "bet_type": "MULTI_WAY_HEAD_TO_HEAD",
  "special_name": "UEFA - Champions League Winner",
  "category": "Futures",
  "units": null,
  "event_id": null,
  "period": null,
  "runner_home": null,
  "runner_away": null,
  "contestant_id": 1631655298,
  "contestant_name": "AEK Athens",
  "starts": "2026-08-27T11:00:00",
  "cutoff": "2026-08-27T11:00:00",
  "timestamp": "2026-07-16T13:15:28"
}
```

<Info>
  Bei Turnier-**Futures** sind `event_id`, `period` und die `runner_*` gleich `null` — der Markt wird durch `special_id` identifiziert. Bei Props, die **an ein Spiel gebunden** sind, trägt `event_id` die `event_id` des Spiels.
</Info>

## Quoten: `/api/specials/odds`

Abfragbar über `event_id` **oder** `special_id` (nützlich für Futures, deren `event_id` gleich `null` ist). Fügen Sie `full_history=1` für die Timeline hinzu.

```bash theme={null}
# Quoten eines Futures über special_id
curl "https://api.apinn.io/api/specials/odds?special_id=1631640230&full_history=1" \
  -H "X-API-Key: DEIN_KEY"
```

Jede Zeile: `special_id`, `special_name`, `contestant_id`, `contestant_name`, `handicap`, `odds`, `todds`, `period`, `cutoff`, `timestamp`.

Eröffnung/Schluss eines Specials: `/api/specials/opening` und `/api/specials/closing`.