Come funziona — Odds & value¶
Il layer quote di BAP V3 risponde a una domanda sola: questa quota ha valore rispetto a un prezzo equo del mercato? Tutto il resto — cattura multi-fase, de-vig, consensus, CLV — esiste per rendere quella risposta misurabile e onesta.
Due canali di cattura, ruoli distinti¶
| Canale | Cosa porta | Dove finisce |
|---|---|---|
| api-football (Via 0) | quote 1X2 / Over-Under / BTTS normalizzate per ~14 bookmaker + mercati estesi Bet365 dal feed | odds_snapshots |
| Worker Bet365 dedicato (Via 2) | la lavagna Bet365 completa (centinaia di quote per match), catturata dal payload di rete in formato DNA su sessione autenticata | bet365_markets |
I due canali sono completamente separati e si fondono solo al momento di servire la lavagna del match. Il worker gira su una macchina dedicata; i dettagli operativi di cattura sono documentazione interna.
Cattura a fasi temporali¶
Le quote non sono un numero, sono una traiettoria. Lo scheduler cattura ogni match in finestre fisse rispetto al kickoff:
| Fase | Quando |
|---|---|
T3D |
~3 giorni prima |
T1D |
~24 ore prima |
T6H |
~6 ore prima |
CLOSING |
~5 minuti prima del kickoff (la più preziosa: è il riferimento del CLV) |
Ogni fase viene ritentata finché non riesce; la CLOSING viene ritentata fino al kickoff.
De-vig (Shin) e consensus¶
Le quote pubblicate dai bookmaker includono il margine (overround): la somma delle probabilità implicite supera il 100%. BAP rimuove il margine con il metodo di Shin, che a differenza della normalizzazione proporzionale modella anche la quota "gonfiata" sui long-shot. Il risultato è la fair odd — il prezzo a margine zero.
Il consensus fonde i book disponibili con pesatura sharp: Pinnacle (il book più efficiente) è il riferimento, gli altri contribuiscono con peso minore. Per ogni selezione la lavagna espone:
fair_odd/fair_prob— il prezzo equo de-vig del consensus;best_odd= MAX tra i book — la quota migliore realmente giocabile;- edge =
best_odd / fair_odd − 1— quanto la quota migliore paga sopra il prezzo equo.
Definizioni rapide di ogni termine: Glossario.

CLV — la metrica di verità¶
Il Closing Line Value confronta il prezzo a cui una posizione è stata presa (o un tip emesso) con la closing line, il prezzo finale del mercato — in letteratura l'unico proxy affidabile di abilità predittiva sul breve periodo (ADR-0004). In BAP il CLV è calcolato fair-vs-fair: de-vig di entrambi i lati (quota alla presa e closing del book più sharp disponibile), così il margine del book non inquina la misura. Se manca uno dei due de-vig, il CLV non viene calcolato: honest-empty, non stima.
Modello statistico e paper trading¶
- Un modello Dixon-Coles (bivariate Poisson con correzione per i punteggi bassi) stima probabilità 1X2/Over-Under per match. È esposto sul sito come misura con pagina di calibrazione pubblica; la valutazione fuori campione sul Mondiale ne ha falsificato l'uso come generatore di pick per-match — e la doc lo dice (vedi Limiti & disclaimer).
- Uno scanner di pick modello genera pick solo su carta (paper trading): edge minimo vs fair Pinnacle nella stessa fase, staking prudenziale quarter-Kelly, astensione come esito di prima classe. Nessun denaro reale; il passaggio a stake reali è dietro un gate CLV esplicito (vedi Visione & roadmap).
Cosa vede l'utente¶
- Lavagna quote del match: mercati raggruppati, quota equa, best odd evidenziata, consensus multi-book o board Bet365 quando disponibile.
- Value del giorno (
/scommesse): le selezioni dove la best odd supera la fair odd, ordinate per edge, con disclaimer 18+ e "non sono previsioni BAP". - Line movement: apertura → corrente per mercato, con direzione e velocità.
Tutto con la stessa regola: sono misure di mercato, non consigli di giocata.