Skip to main content
/api/settlement?event_id=… devuelve el marcador final, el estado y el settlement por línea.

​
Outcomes

Cada línea del settlement lleva outcome_home, outcome_draw, outcome_away:
El settlement cubre todos los periodos cotizados — partido completo, mitad, cuarto, set — en cuanto se conoce el marcador de ese periodo. Cada línea lleva su period. Un periodo cuyo marcador sigue siendo desconocido no produce ninguna línea en lugar de un veredicto aproximado: la cobertura medida es del 87 % de los pares (evento, periodo), 97 % en fútbol, 73 % en tenis cuyos periodos son juegos. Mientras el partido no esté liquidado, settlement está vacío y status refleja el estado actual (started, pending); pasa a ended al liquidarse.

​
Líneas de cuarto

Una línea en .25 o .75 no es una línea sino dos apuestas de media cantidad, colocadas en line ± 0.25. En un hándicap -0.25 con empate, la mitad puesta en 0 se devuelve y la mitad puesta en -0.5 se pierde: el veredicto es half_loss, no loss. Las dos mitades nunca pueden contradecirse — están separadas por 0,5 y el margen de una línea de cuarto nunca vale cero. Solo existen la media victoria y la media derrota.

​
Resultados por periodo

/api/results?event_id=… es una ruta distinta, en formato iso‑BIC: devuelve un array, un objeto por periodo liquidado. En los deportes por sets, cada set y cada juego es un resultado binario (1‑0 / 0‑1); el periodo 0 lleva el recuento de sets.
Cobertura actual: deportes por sets (tenis, voleibol, tenis de mesa…). En los deportes de marcador continuo — fútbol, baloncesto, béisbol — Pinnacle no publica liquidación por periodo en el flujo en tiempo real, y /api/results devuelve un array vacío. Use /api/settlement para esos deportes.

​
Descubrir los partidos liquidados

/api/settled?since=… recorre los partidos liquidados de forma incremental: cada respuesta lleva un cursor last que se vuelve a pasar en la siguiente llamada. Es la única forma de descubrir una liquidación. Un partido liquidado ha salido del book — su desaparición es lo que dispara la liquidación — por lo que ya no aparece en /api/fixtures, ni siquiera con live=2. Sin este recorrido, habría que haber memorizado el event_id antes del final del partido.
La comparación de since es inclusiva: el último evento de una página puede reaparecer al principio de la siguiente. Varios partidos pueden compartir el segundo de liquidación, y perder uno sería peor que devolverlo dos veces — deduplique por event_id. Filtros disponibles: sport_id, league_id, limit (1 a 1000, por defecto 200).

​
Backtesting

La combinación de historial cronológico + apertura/cierre + true odds + settlement permite backtestear estrategias: reconstruir las cuotas en cualquier momento, medir el CLV y comprobar el resultado.