Flusso in tempo reale (SSE)

/api/stream è un flusso Server‑Sent Events: alla connessione ricevi uno snapshot del board, poi ogni cambiamento viene inviato (nessun polling). Poiché EventSource non permette header custom, passa la chiave in query: ?key=TUA_CHIAVE.

Node.js

import { EventSource } from "eventsource";

const es = new EventSource("https://api.apinn.io/api/stream?key=TUA_CHIAVE");

es.addEventListener("snapshot", (e) => {
  const { events } = JSON.parse(e.data);
  console.log("snapshot iniziale:", events.length, "match");
});

es.addEventListener("update", (e) => {
  const { events } = JSON.parse(e.data);
  // events = match le cui quote principali sono cambiate
});

es.addEventListener("remove", (e) => {
  const { ids } = JSON.parse(e.data);
  // match rimossi dal board (terminati)
});

Tipi di eventi

Evento	Payload	Significato
`snapshot`	`{ events: [...] }`	Stato iniziale del board alla connessione.
`update`	`{ events: [...] }`	Match le cui quote principali sono cambiate.
`remove`	`{ ids: [...] }`	Match rimossi (terminati).

Ogni elemento events riporta l’event_id, le squadre, il live_status e le quote principali (moneyline/spread/totals).

Il flusso apre una connessione lunga e conta come 1 richiesta al momento della connessione.

Risultati & settlement

⌘I

​Tipi di eventi

Tipi di eventi