Il problema
Chi fa trading sugli exchange di scommesse lavora spesso con fogli di calcolo e a sensazione. Non ha un posto sicuro dove provare una strategia prima di mettere in gioco soldi veri, né un registro unico di puntate, limiti e risultati. C’era anche un vincolo preciso: durante i test, Betfair Italia rifiutava le richieste di scommessa inviate tramite la sua API da server in datacenter.
Cosa ho costruito
Ho realizzato BetPilot AI, una piattaforma web installabile per analisi, controllo del rischio e simulazione, in cui ogni strategia parte in paper trading.
- Editor visuale di strategie — le strategie vengono salvate come schema dichiarativo, verificato su una whitelist rigorosa. Il codice dell’utente non viene mai eseguito.
- Assistente AI per le strategie — l’utente descrive una strategia a parole e Claude (Anthropic) la trasforma in uno schema, oppure ne migliora uno esistente. Se la risposta non supera la validazione, l’errore torna al modello per un nuovo tentativo.
- Motore di simulazione — backtest, replay e confronti girano come processi in background. Il motore di abbinamento tiene conto di liquidità, abbinamenti parziali, slippage e latenza, ed è deterministico: a parità di dati in ingresso, il risultato è lo stesso.
- Motore di rischio e segnali — limiti di budget (intervallo di puntata, perdita massima giornaliera e settimanale, intervallo di quote) e un consulente per la puntata: un quarto di Kelly con tetto al 5% del bankroll quando è indicata una probabilità, altrimenti la regola del 2%. Ogni segnale mostra la quota equa e il valore atteso.
- Diario reale — l’utente registra ogni scommessa reale con un clic; bankroll, P&L, ROI e percentuale di vincita restano sempre aggiornati.
- Dati in tempo reale — statistiche delle partite da API-Football e prezzi dell’exchange da un agente in sola lettura installato sul computer dell’utente.
- Sicurezza e registri — accesso a due fattori, segreti cifrati, dati isolati per utente, registro delle operazioni, report in PDF, CSV e XLSX, notifiche via email, push e webhook.
I numeri
- Una suite di test automatici, compreso un test che dimostra che il motore di simulazione non può inviare ordini reali.
- 18 moduli di back end e 42 modelli di dati nello schema del database.
- 7 sport e 6 metodi per dimensionare la puntata supportati dal formato delle strategie.
Con cosa è fatto
Front end in Next.js, React e TypeScript con Tailwind CSS e Recharts, esportato come file statici. Back end in NestJS con Clean Architecture, moduli orientati al dominio e CQRS, su PostgreSQL tramite Prisma. Redis e BullMQ gestiscono la coda dei processi, con PostgreSQL come riserva. Integrazioni: API di Anthropic, API-Football e API di Betfair in sola lettura.
Perché è fatto così
Quando l’exchange ha bloccato le scommesse inviate dal server, ho cambiato modello. BetPilot analizza, calcola la puntata e tiene i conti; la scommessa la piazza la persona. Per i dati di mercato ho scritto un agente locale che chiama solo i metodi di lettura di Betfair e tiene le credenziali sul PC dell’utente. I metodi di scommessa sono bloccati per costruzione, così il software resta uno strumento di supporto alle decisioni.
