API per sportsbook: quote, scommesse e saldo in un'unica integrazione

Un'API pensata per chi costruisce il proprio front end: ricevi le quote, piazzi le giocate, consulti lo storico e controlli il rischio.

Aggiornato il 5 ottobre 2026

L'API sportsbook di Nocturn Sport è il modo più diretto per aggiungere le scommesse sportive a una piattaforma esistente. Riceve il palinsesto con le nostre quote proprietarie, permette di registrare le giocate dei tuoi utenti e restituisce storico e saldo. È la scelta giusta per operatori con un team di sviluppo che vuole il pieno controllo dell'interfaccia.

1. Il feed delle quote: snapshot e delta versionati

Alla prima connessione il client scarica un'istantanea completa del palinsesto pre-partita: sport, tornei, eventi, mercati ed esiti con le rispettive quote. Da quel momento non serve riscaricare tutto: il client interroga l'API con l'ultimo numero di versione che conosce, circa ogni dieci secondi, e riceve solo le differenze (delta) intervenute da allora. Nuovi eventi, quote modificate, mercati sospesi o chiusi arrivano così in modo leggero e ordinato.

Questo meccanismo riduce il traffico e rende semplice ricostruire lo stato in caso di disconnessione: basta ripartire dall'ultima versione salvata. La struttura dei dati è descritta nella pagina feed delle quote.

2. Piazzamento delle scommesse

L'API accetta scommesse singole e multiple. Ogni richiesta porta un identificativo univoco (request ID): se la rete cade e il client ripete la chiamata, la stessa giocata non viene registrata due volte. Al momento della richiesta la quota viene confrontata con quella attuale e con i limiti impostati: quota minima e massima, puntata massima, vincita massima, numero massimo di selezioni per schedina e tempo di chiusura prima dell'evento.

3. Storico e saldo

• Storico delle scommesse: elenco delle giocate di un utente con stato (aperta, vinta, persa) e dettaglio delle selezioni.
• Saldo del giocatore: lettura del saldo per mostrare all'utente quanto può puntare e per riconciliare le operazioni.

4. Controlli dal back office

L'integrazione tecnica va di pari passo con il controllo operativo. Dal back office il tuo team di trading può sospendere un evento, forzare una quota, inserire il risultato per refertare, vedere l'esposizione su ogni mercato e regolare il margine, che si applica in modo proporzionale su tutti gli esiti di un mercato. Ogni modifica si riflette nel feed con una nuova versione.

5. Cosa c'è dietro le quote

Il feed non ritrasmette prezzi altrui: le quote nascono dai nostri modelli di Elo, Poisson e distribuzione normale, a seconda dello sport. La spiegazione per gli operatori è nella pagina quote proprietarie. Oggi il feed è pre-partita; le quote in diretta sono in sviluppo.

Integrazione e contatti

Puoi integrare l'API direttamente oppure passare da SoftAggregator, che con un solo collegamento fornisce giochi da casinò e sportsbook. Documentazione tecnica, credenziali di test e prezzi (su richiesta) si ottengono scrivendo a [email protected], su Telegram @mentionso o dalla pagina contatti. Se ti serve anche l'interfaccia, guarda la soluzione white label o la panoramica sul software sportsbook.

Leggi anche