Quote Pinnacle in tempo reale, via WebSocket

PinnFeed è un'API delle quote Pinnacle pensata per chi programma: un unico WebSocket che prima invia uno snapshot e poi solo ciò che è cambiato. Filtri lato server per sport, campionato e mercato, ogni linea arriva con la sua quota equa senza margine e la quota di chiusura viene archiviata. Non serve un conto Pinnacle.

Il piano WebSocket è Builder, 99 €/mese (IVA inclusa): push in tempo reale, tutti i 13 sport, tutti i mercati e le quote di chiusura. Ogni piano a pagamento parte con 3 giorni gratis (carta obbligatoria; l'addebito arriva il quarto giorno se non disdici).

Fatto per il bot, non per il browser#

Tutto quello che altrimenti dovresti scrivere tu (riconnessione, regole di merge, conversione delle quote, rimozione del margine, rilevamento del calcio d'inizio) lo facciamo una volta sola dal nostro lato e ti arriva come JSON pulito.

• Push, niente polling. Ti iscrivi una volta e ricevi i delta. Un mercato fermo non ti costa nulla.
• Filtri lato server. Per sport, campionato, evento, tipo di mercato e live o pre-match. Ricevi solo quello che chiedi.
• Quote eque e chiusura. Ogni mercato porta il suo margine e una quota equa decimale per esito. Al calcio d'inizio l'ultimo prezzo pre-match viene salvato come quota di chiusura.
• Schema stabile. Eventi e mercati con id stabili, quote decimali e americane, linee, periodi, puntata massima e orario di chiusura.
• MCP ospitato. Un server MCP su /mcp permette a Claude, Cursor, Copilot e ChatGPT di leggere con la tua chiave quote live, dropping odds e quote di chiusura.
• Chiavi self-service. Crea, rinomina e revoca le chiavi, guarda l'uso per chiave e cambia piano dalla dashboard.

I 13 sport: calcio, tennis, basket, hockey su ghiaccio, football americano, baseball, rugby, MMA, boxe, pallavolo e pallamano, esport, golf e cricket.

Un client che funziona#

Ti connetti, ti iscrivi al calcio live e vedi ogni movimento. È un normale WebSocket con JSON: Python, Node o qualsiasi altro linguaggio.

# pip install websockets
import asyncio, json, os, websockets

async def main():
    async with websockets.connect("wss://pinnfeed.io/v1/stream",
                                  additional_headers={"x-api-key": os.environ["PINNFEED_KEY"]}) as ws:
        await ws.send(json.dumps({"type": "subscribe", "sports": ["soccer"], "live": True, "markets": ["moneyline"], "main": True}))
        async for raw in ws:
            msg = json.loads(raw)
            if msg["type"] == "ping":
                await ws.send('{"type":"pong"}')  # rispondi all'heartbeat o il server chiude
            elif msg["type"] == "delta":
                print(len(msg["changes"]), "changes")

asyncio.run(main())

Il client completo, con book in memoria e riconnessione, è nella guida Python e Node.

Prima lo snapshot, poi solo le variazioni#

• Snapshot e delta. Uno snapshot in più parti all'iscrizione, poi solo i mercati che cambiano, raggruppati per aggiornamento.
• Le rimozioni sono esplicite. I mercati sospesi o refertati arrivano come op: "remove", così il tuo book non mostra mai prezzi vecchi.
• REST rispecchia il socket. Gli stessi oggetti arrivano da GET /v1/odds per cron job e caricamenti storici.

Push contro polling: i conti#

Un client che fa polling vede una variazione solo alla richiesta successiva: in media arriva con mezzo intervallo di ritardo, nel caso peggiore con un intervallo intero, più il tempo di andata e ritorno. Un WebSocket non ha intervallo. È aritmetica, non un benchmark: puoi verificarla da solo.

Il transito di rete e l'elaborazione riguardano entrambi e non sono inclusi. Il nostro REST del piano Free ha 30 s di ritardo di proposito; il REST di Hobby e tutti i piani WebSocket sono in tempo reale.

Prezzi#

Il prezzo del WebSocket, con la sua precisazione: al 9 novembre 2026 Builder era il prezzo mensile pubblicato più basso che abbiamo trovato per un WebSocket di quote Pinnacle live + pre-match. Cifre, fonti e riserve sono nella pagina del prezzo. Vedi tutti i limiti.

Domande frequenti#

Esiste ancora un'API pubblica di Pinnacle?#

Pinnacle ha chiuso la sua API pubblica alla maggior parte degli utenti a luglio 2025. PinnFeed è un servizio indipendente che distribuisce i prezzi di Pinnacle agli sviluppatori tramite un WebSocket normalizzato e un'API REST. Non serve un conto Pinnacle.

Perché un WebSocket invece del polling di un'API REST?#

Un client che fa polling vede una variazione solo alla richiesta successiva, quindi in media con mezzo intervallo di ritardo. Con il WebSocket, PinnFeed invia ogni variazione appena arriva al nostro server, filtrata su ciò a cui sei iscritto e con le quote eque. Builder (99 €/mese) è il piano WebSocket.

Cos'è una quota equa (senza margine)?#

I prezzi di Pinnacle includono un margine. Lo togliamo con il metodo moltiplicativo e restituiamo per ogni esito la probabilità equa e la quota decimale equa, così confronti qualsiasi bookmaker con la linea più affilata senza fare conti.

C'è un piano gratuito?#

Sì. Il piano Free dà accesso REST a due sport con 30 secondi di ritardo e 1.000 richieste al giorno, senza carta. Hobby (29 €/mese) rende il REST in tempo reale; Builder (99 €/mese) aggiunge il WebSocket in tempo reale.

Posso disdire quando voglio?#

Sì. Ogni piano a pagamento parte con 3 giorni gratis (carta obbligatoria, addebito il quarto giorno se non disdici) ed è mensile tramite Stripe; disdici o cambi piano dalla dashboard con un clic. I piani in cripto sono prepagati per 1, 3 o 12 mesi e non si rinnovano mai da soli.

I contenuti sono riservati ai maggiorenni?#

Sì. PinnFeed è uno strumento di dati e i suoi contenuti sono educativi, per maggiori di 18 anni. Niente qui è un pronostico o una promessa di guadagno. Gioca responsabilmente e solo dove è legale.