NOCTURN SPORT

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 27 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 quote di Nocturn Sport, 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: 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.

Valute e criptovalute. Ogni giocatore usa una sola valuta, valida per saldo, puntata e vincita. Lo sportsbook ne gestisce 73: 60 valute fiat e 13 unità crypto, cioè USDT, USDC, BTC (visualizzabile anche in mBTC e SATS), ETH, LTC, TRX, DOGE, SOL, XRP, BNB e TON. I tassi di cambio vengono aggiornati ogni ora e i limiti di puntata impostati in euro sono convertiti in ciascuna valuta: chi gioca in USDT e chi gioca in lire turche trova gli stessi tetti. L'elenco aggiornato è pubblico su nocturnsport.com/api/currencies.

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 motore di quote. Nel feed passa anche il live di quattro sport (calcio, tennis, basket, cricket) con risultato, tempo di gioco e sospensioni; i mercati dettagliati (giocatori, angoli, cartellini…) si ottengono partita per partita su richiesta, e ogni operatore imposta il proprio ritardo per le giocate live.

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.

Le novità di Nocturn Sport

  • Scommesse live: calcio, basket, tennis e cricket
  • Cash-out prima del fischio d'inizio
  • Mercati giocatore
  • Calci d'angolo, cartellini e statistiche
  • Un menu calcio molto ricco
  • Quote maggiorate
  • Più profondità negli altri sport
  • Allerte di integrità
  • Impostazioni per operatore

Vedi tutti i mercati e le opzioni →

Domande frequenti

Ogni quanto devo interrogare il feed?

Circa ogni dieci secondi, passando l'ultima versione ricevuta: l'API restituisce solo le modifiche successive.

Cosa succede se invio due volte la stessa scommessa?

Il request ID identifica la richiesta: una ripetizione con lo stesso identificativo non crea una seconda giocata.

L'API gestisce le multiple?

Sì, singole e multiple, con un massimo di selezioni per schedina che puoi impostare tu dal back office.

I giocatori possono scommettere in criptovaluta?

Sì. Stablecoin, Bitcoin, Ether, Tron, Toncoin e altre monete principali affiancano le valute tradizionali, senza modifiche all'integrazione: basta passare il codice valuta del giocatore e l'API fa il resto.

Come richiedo la documentazione?

Scrivi a [email protected] o su Telegram a @mentionso: ti inviamo documentazione e accesso di test.

Leggi anche