period, market, line) e riporta un line_id intero stabile.
Tipi di mercato
Per i mercati 2‑way (spread/totals),
odds0 è null.
units — l’unità della linea (tennis: game vs set)
Alcuni sport quotano lo stesso mercato in due unità diverse. Nel tennis, uno spread può essere un
handicap di set (linea ±1.5) o un handicap di game (linea -4.5, +5.5…), e un totals può riferirsi
ai set (2.5) o ai game (21.5). Il campo units elimina l’ambiguità:
I totali per giocatore (
home_totals / away_totals) del tennis sono sempre in game (units = "Games").
Il campo è presente su /api/odds, /api/opening, /api/closing, /api/history e sui flussi in tempo reale.
Periodi
period = 0 = match completo. Gli altri periodi dipendono dallo sport (1 = 1° tempo / set, ecc.). Recupera il catalogo tramite /api/periods.
Linee principali vs alt‑lines
Per impostazione predefinita,/api/odds restituisce tutte le linee (incluse le alternative). Aggiungi main_lines_only=1 per mantenere solo la linea principale di ogni mercato (alt_line_id nullo).
max_win
max_win = puntata massima accettata (limite Pinnacle) sulla linea, indicatore di liquidità.
Storico: max_win e status sono punti della serie
/api/history restituisce un punto per ogni cambiamento reale, mai un valore ripetuto. Un punto
viene creato non appena uno di questi campi cambia:
Un
max_win che sale mentre la quota resta ferma è un segnale di fiducia del bookmaker; un
max_win che crolla precede spesso una sospensione. La serie è già deduplicata lato server.
Isolare una singola scommessa
Senza filtro,/api/history restituisce la cronologia di tutte le linee della partita. Su una
partita di basket con le sue alt-line si superano abitualmente i 24.000 punti distribuiti su più di
400 scommesse — mentre a lei serviva una sola curva.
Due modi per indicare la scommessa, a seconda di ciò che ha già a disposizione:
I filtri valgono anche per
opening e closing: ottiene apertura e chiusura della scommessa
richiesta, non quelle delle altre 414.
Misurato su una partita reale:
I tre livelli di stato
Pinnacle pubblica uno stato su tre scale diverse, ciascuna con il proprio vocabolario. Confonderle è l’errore più frequente: un mercato chiuso non significa una partita finita, e un tempo liquidato non chiude le scommesse sull’intera partita.Livello linea
Lo stato appartiene alla linea, non al mercato. All’interno dello stesso(event_id, period, market) i gradini divergono — Pinnacle chiude un total preciso e lascia aperti
i vicini:
status, un intero in parità BIC (1 = aperto, 2 = tutto il resto), e
status_raw, la parola così come la invia Pinnacle.
status_raw è valorizzato solo sulle quote correnti. Lo storico (/api/history,
full_history=1) conserva soltanto l’intero: la parola originale non viene memorizzata, quindi lì
il campo vale null.Livello periodo
/api/fixtures espone periods, un elenco {period, status, cutoff}. È qui che Pinnacle dichiara
che un tempo è chiuso, indipendentemente dalle linee e dallo stato della partita:
La liquidazione di un periodo è un evento a sé sul flusso: un tempo che passa a
settled
innesca un frame event: update, senza che alcuna quota debba muoversi.Distinguere una sospensione da una chiusura definitiva
Non lo dice un campo: lo dice il tempo:- sospensione — la linea resta pubblicata, passa a
closed, conserva l’ultima quota nota (non la cancelliamo, come l’interfaccia Pinnacle che rende grigio il prezzo), poi tornaopen; - chiusura definitiva — la linea smette di essere ripubblicata: il suo
cutoffscade, esce da/api/oddse una rimozione viene annunciata sul flusso (vedi Prematch e live).