Risultati e settlement

/api/settlement?event_id=… restituisce il punteggio finale, lo stato e il settlement per linea.

{
  "event_id": 1632370816,
  "score_home": 0,
  "score_away": 0,
  "status": "ended",
  "settled_at": "2026-07-16T01:13:02",
  "settlement": [
    {
      "line_id": 812345678,
      "event_id": 1632370816,
      "period": 0,
      "market": "moneyline",
      "line": null,
      "outcome_home": "loss",
      "outcome_draw": "win",
      "outcome_away": "loss",
      "score_home": 0,
      "score_away": 0,
      "settled_at": "2026-07-16T01:13:02"
    }
  ]
}

Outcomes

Ogni riga del settlement porta outcome_home, outcome_draw, outcome_away:

Valore	Significato
`win`	La scommessa su questo lato vince.
`loss`	La scommessa perde.
`push`	Rimborsata (nulla su handicap/total).
`half_win`	Mezza vittoria — linea a quarti: metà della puntata vince, l’altra è rimborsata.
`half_loss`	Mezza perdita — linea a quarti: metà perde, l’altra è rimborsata.
`null`	Non applicabile (es. nessun draw su un mercato 2‑way).

Il settlement copre tutti i periodi quotati — partita intera, tempo, quarto, set — non appena il punteggio del periodo è noto. Ogni riga porta il suo period. Un periodo il cui punteggio resta ignoto non produce alcuna riga invece di un verdetto approssimato: la copertura misurata è dell’87 % delle coppie (evento, periodo), 97 % nel calcio, 73 % nel tennis i cui periodi sono giochi. Finché la partita non è regolata, settlement è vuoto e status riflette lo stato corrente (started, pending); passa a ended al regolamento.

Linee a quarti

Una linea in .25 o .75 non è una linea ma due scommesse da metà puntata, poste a line ± 0.25. Su un handicap -0.25 con pareggio, la metà posta su 0 è rimborsata e la metà posta su -0.5 è persa: il verdetto è half_loss, non loss. Le due metà non possono mai contraddirsi — distano 0,5 e il margine di una linea a quarti non vale mai zero. Esistono solo la mezza vittoria e la mezza perdita.

Risultati per periodo

/api/results?event_id=… è una rotta distinta, in formato iso‑BIC: restituisce un array, un oggetto per periodo regolato. Negli sport a set, ogni set e ogni gioco è un risultato binario (1‑0 / 0‑1); il periodo 0 porta il conteggio dei set.

[
  {
    "event_id": 1633177791,
    "period": 1,
    "status": 1,
    "score_home": 3,
    "score_away": 6,
    "sets_home": null,
    "sets_away": null,
    "settlement_id": 25000002,
    "cancellation_reason": null,
    "timestamp": "2026-08-01T23:32:10"
  }
]

Copertura attuale: sport a set (tennis, pallavolo, tennistavolo…). Negli sport a punteggio continuo — calcio, basket, baseball — Pinnacle non pubblica il regolamento per periodo nel flusso in tempo reale, e /api/results restituisce un array vuoto. Per questi sport usa /api/settlement.

Scoprire le partite regolate

/api/settled?since=… percorre le partite regolate in modo incrementale: ogni risposta porta un cursore last da ripassare alla chiamata successiva. È l’unico modo per scoprire un regolamento. Una partita regolata ha lasciato il book — è la sua scomparsa a innescare il regolamento — quindi non compare più in /api/fixtures, nemmeno con live=2. Senza questo percorso, occorrerebbe aver memorizzato l’event_id prima della fine della partita.

# 1er appel : les règlements des dernières 24 h
curl "https://api.apinn.io/api/settled?limit=50" -H "X-API-Key: VOTRE_CLE"

# appels suivants : repasser le `last` reçu
curl "https://api.apinn.io/api/settled?since=1785636831" -H "X-API-Key: VOTRE_CLE"

Il confronto su since è inclusivo: l’ultimo evento di una pagina può ricomparire in testa alla successiva. Più partite possono condividere il secondo di regolamento, e perderne una sarebbe peggio che restituirla due volte — deduplica su event_id. Filtri disponibili: sport_id, league_id, limit (da 1 a 1000, predefinito 200).

Backtesting

La combinazione di storico cronologico + apertura/chiusura + true odds + settlement permette di backtestare strategie: ricostruire le quote in qualsiasi istante, misurare il CLV e verificare il risultato.

Iniziare

Concetti

Risultati e settlement

Outcomes

Linee a quarti

Risultati per periodo

Scoprire le partite regolate

Backtesting

​Outcomes

​Linee a quarti

​Risultati per periodo

​Scoprire le partite regolate

​Backtesting

Outcomes

Linee a quarti

Risultati per periodo

Scoprire le partite regolate

Backtesting