Skip to main content
/api/settlement?event_id=… devolve o placar final, o estado e o settlement por linha.

​
Outcomes

Cada linha do settlement traz outcome_home, outcome_draw, outcome_away:
O settlement cobre todos os períodos cotados — jogo completo, parte, quarto, set — assim que o resultado desse período é conhecido. Cada linha traz o seu period. Um período cujo resultado permanece desconhecido não produz nenhuma linha em vez de um veredicto aproximado: a cobertura medida é de 87 % dos pares (evento, período), 97 % no futebol, 73 % no ténis cujos períodos são jogos. Enquanto o jogo não estiver liquidado, settlement está vazio e status reflete o estado atual (started, pending); passa a ended na liquidação.

​
Linhas de quarto

Uma linha em .25 ou .75 não é uma linha mas duas apostas de meia quantia, colocadas em line ± 0.25. Num handicap -0.25 com empate, a metade posta em 0 é devolvida e a metade posta em -0.5 é perdida: o veredicto é half_loss, não loss. As duas metades nunca se podem contradizer — distam 0,5 e a margem de uma linha de quarto nunca vale zero. Só existem a meia vitória e a meia derrota.

​
Resultados por período

/api/results?event_id=… é uma rota distinta, em formato iso‑BIC: devolve um array, um objeto por período liquidado. Nos desportos por sets, cada set e cada jogo é um resultado binário (1‑0 / 0‑1); o período 0 traz a contagem de sets.
Cobertura atual: desportos por sets (ténis, voleibol, ténis de mesa…). Nos desportos de placar contínuo — futebol, basquetebol, basebol — a Pinnacle não publica liquidação por período no fluxo em tempo real, e /api/results devolve um array vazio. Use /api/settlement para esses desportos.

​
Descobrir os jogos liquidados

/api/settled?since=… percorre os jogos liquidados de forma incremental: cada resposta traz um cursor last a devolver na chamada seguinte. É a única forma de descobrir uma liquidação. Um jogo liquidado saiu do book — o seu desaparecimento é o que despoleta a liquidação — pelo que já não aparece em /api/fixtures, nem sequer com live=2. Sem este percurso, seria preciso ter memorizado o event_id antes do fim do jogo.
A comparação de since é inclusiva: o último evento de uma página pode reaparecer no topo da seguinte. Vários jogos podem partilhar o segundo de liquidação, e perder um seria pior do que devolvê-lo duas vezes — desduplique por event_id. Filtros disponíveis: sport_id, league_id, limit (1 a 1000, por omissão 200).

​
Backtesting

A combinação de histórico cronológico + abertura/fecho + true odds + settlement permite backtestar estratégias: reconstruir as odds em qualquer instante, medir o CLV e verificar o resultado.