Skip to main content
Un match apparaît d’abord en prématch avec son event_id. Au coup d’envoi, Pinnacle crée un événement live séparé (son propre event_id), relié au prématch par parent_id.
  • Les cotes prématch vivent sous l’event_id prématch.
  • La série in‑play (avec score_home, score_away, red_cards_* sur chaque ligne) vit sous l’event_id de l’enfant live.

​
Trouver l’enfant live d’un match

Le match principal est la ligne dont resulting_unit = "Regular".

​
live_status

Le champ live_status d’un fixture vaut :

​
Corners, cartons & variantes

Corners et Bookings sont des fixtures séparés pointant vers le match principal via parent_id. Avec parent_id=X (sans live), vous récupérez ces variantes ; avec live=1, l’enfant live.

​
Savoir qu’un marché ou un match n’est plus proposé

Pinnacle n’annonce jamais la fin d’un match. Il ne publie pas de statut « terminé » : il fait disparaître l’objet du flux. La disparition est le message. Un client qui attend un état final l’attendra indéfiniment. Deux disparitions distinctes, deux signaux : Chaque entrée de removed identifie la ligne par event_id, period, market, line et units :
Faites correspondre units comme les autres champs. Au tennis, un même match publie ses cotes en jeux et en sets : un spread -1.5 en sets et un spread -1.5 en jeux partagent event_id, period, market et line, et seul units les distingue. Ignorer ce champ ferait supprimer une série encore cotée.
Le retrait d’un match attend 30 secondes avant d’être annoncé. Un marché suspendu quitte le board puis y revient ; sans ce délai, une suspension de quelques secondes serait signalée comme une fin de match.

​
En REST, sans flux

Il n’y a pas de notification : l’absence est le signal. Une ligne qui ne figure plus dans /api/odds n’est plus jouable, un match qui ne figure plus dans /api/fixtures n’est plus proposé. Les deux sont cohérents entre eux — un match retiré par Pinnacle disparaît des deux. Pour retrouver un match une fois qu’il a quitté le book, utilisez /api/settled avec un curseur since : c’est le seul endroit où un match terminé réapparaît, avec son règlement.

​
Le cas des lignes abandonnées au passage en live

Au coup d’envoi, Pinnacle ne reprend pas toutes ses lignes en direct. Celles qu’il abandonne gardent leur ancien cutoff, qui devient donc passé — et nous cessons de les servir. Vous ne verrez jamais une cote dont le cutoff est dépassé. Ce n’est pas une affaire de type de marché : ce sont des lignes précises qui disparaissent, tous marchés confondus. Sur un match de football en direct, home_totals peut très bien continuer d’être coté pendant qu’un spread -1.25 s’arrête. La ligne retirée du book reste intégralement dans l’historique : /api/history conserve son ouverture, sa clôture et sa timeline complète.