Specials & outrights

Specials cover props (scorers, combos…) and outrights / futures (tournament winner, top finish…).

Catalog: `/api/specials/outrights`

Returns one line per market × contestant, with metadata (without odds):

{
  "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"
}

For tournament futures, event_id, period and the runner_* fields are null — the market is identified by special_id. For props attached to a match, event_id carries the match’s event_id.

Odds: `/api/specials/odds`

Queryable by event_id or special_id (useful for futures whose event_id is null). Add full_history=1 for the timeline.

# odds for a future via special_id
curl "https://api.apinn.io/api/specials/odds?special_id=1631640230&full_history=1" \
  -H "X-API-Key: YOUR_KEY"

Each line: special_id, special_name, contestant_id, contestant_name, handicap, odds, todds, period, cutoff, timestamp. Opening/closing of a special: /api/specials/opening and /api/specials/closing.

​Catalog: /api/specials/outrights

​Odds: /api/specials/odds

Catalog: `/api/specials/outrights`

Odds: `/api/specials/odds`