Skip to main content
API Quote Storiche

Quote storiche per backtesting e modelli

Quote di chiusura dei bookmaker che scegli, con il risultato finale incluso. Scarica la stagione intera di un campionato in poche richieste, o un evento alla volta, con la stessa API key che usi per le quote live.

Ultimo aggiornamento

Quote di chiusura dal
dic 2025
Per richiesta bulk
366 giorni
Bookmaker per richiesta
30
Campionati per richiesta
10

Un mese di quote di chiusura in una sola richiesta

/v3/historical/closing-lines restituisce ogni evento refertato nel periodo con le sue quote di chiusura e il risultato finale. Compaiono anche gli eventi senza quote dai tuoi bookmaker, con un oggetto bookmakers vuoto, così una quota mancante non sembra mai una partita mancante.

Richiesta
curl "https://api.odds-api.io/v3/historical/closing-lines?apiKey=YOUR_API_KEY\
&sport=football&leagues=england-premier-league,spain-la-liga\
&from=2026-01-01T00:00:00Z&to=2026-01-31T23:59:59Z\
&markets=ML&bookmakers=Bet365,Unibet&limit=100"
Risposta (ridotta)
[
  {
    "id": 123456,
    "home": "Arsenal",
    "away": "Chelsea",
    "date": "2026-01-14T20:00:00Z",
    "status": "settled",
    "league": { "name": "England - Premier League", "slug": "england-premier-league" },
    "scores": { "home": 2, "away": 1 },
    "bookmakers": {
      "Bet365": [
        {
          "name": "ML",
          "updatedAt": "2026-01-14T19:58:12Z",
          "odds": [{ "home": "2.10", "draw": "3.40", "away": "3.60" }]
        }
      ]
    }
  }
]

Endpoint storici

Quattro endpoint storici e uno per i movimenti di linea. Il riferimento API riporta ogni parametro.

GET/v3/historical/closing-lines
Quote di chiusura per molti eventi insieme: fino a 10 campionati, 366 giorni, 30 bookmaker e i mercati che indichi.Piani a pagamento
GET/v3/historical/odds
Quote di chiusura e risultato finale di un evento concluso, per un massimo di 30 bookmaker.Tutti i piani
GET/v3/historical/events
Partite refertate e risultati finali di un campionato in un intervallo fino a 31 giorni.Tutti i piani
GET/v3/historical/events/search
Eventi refertati per nome della squadra in tutti i campionati, dal più recente.Tutti i piani
GET/v3/odds/movements
Movimento di linea pre-match per un mercato: la quota di apertura, l'ultima quota e le variazioni intermedie.Tutti i piani

Scarica una stagione in tre passi

  1. 1

    Scegli campionati e date

    Scegli uno sport, fino a 10 slug di campionato e un intervallo di date fino a 366 giorni, così un'intera stagione rientra in un solo passaggio.

  2. 2

    Indica mercati e bookmaker

    markets e bookmakers sono obbligatori sull'endpoint bulk, fino a 30 bookmaker. Va bene qualsiasi nome di /v3/bookmakers, e le quote tornano con lo stesso nome.

  3. 3

    Scorri la stagione pagina per pagina

    Ogni risposta contiene fino a 100 eventi refertati. Aggiungi skip finché una pagina non torna incompleta. Una stagione da 240 partite richiede tre richieste.

Cosa costruiscono gli sviluppatori

Backtest di un modello di scommesse

Applica un modello a una stagione passata e confronta i suoi prezzi con la chiusura di ogni bookmaker, con il risultato finale nella stessa risposta.

Misura il closing line value

Confronta la quota che hai preso con quella di chiusura. Lo storico dei movimenti ti dà anche la quota di apertura, così vedi quanto si è spostata la linea.

Crea un dataset di training

Scarica le quote di chiusura di cinque campionati per una stagione in circa 20 richieste invece di circa 1.900 chiamate, una per partita, in JSON da caricare direttamente in un dataframe.

Profondità dei dati e limiti

Gli elenchi di eventi e le quote di chiusura bulk restituiscono solo eventi refertati. I nomi dei mercati sono gli stessi serviti da /v3/odds, quindi dati storici e live si uniscono sulle stesse chiavi.

Storico delle quote di chiusura
Da dicembre 2025
Intervallo di date, quote di chiusura bulk
366 giorni
Intervallo di date, eventi e ricerca
31 giorni
Campionati per richiesta bulk
10
Bookmaker per richiesta
30
Eventi per risposta bulk
100, paginazione con skip
Formato
JSON via REST

Domande frequenti sulla API Quote Storiche

Da quando sono disponibili i dati storici delle quote?

Le quote di chiusura sono disponibili da dicembre 2025. Partite e risultati finali precedenti restano disponibili da /v3/historical/events, ma gli endpoint delle quote restituiscono quegli eventi con un oggetto bookmakers vuoto.

Quale endpoint devo usare per un'intera stagione?

/v3/historical/closing-lines. Accetta fino a 10 campionati e 366 giorni per richiesta e restituisce fino a 100 eventi refertati per pagina. Scaricare cinque campionati per una stagione un evento alla volta richiede circa 1.900 richieste; l'endpoint bulk restituisce gli stessi dati in circa 20.

I dati storici delle quote sono inclusi nel mio piano?

/v3/historical/events, /v3/historical/events/search e /v3/historical/odds sono disponibili in tutti i piani. /v3/historical/closing-lines richiede un piano a pagamento. Le nuove chiavi gratuite sono sospese, quindi Solo a 49 £/mese è il modo più economico per iniziare.

Quali mercati e bookmaker sono coperti?

Le quote di chiusura vengono salvate per gli eventi refertati su ogni bookmaker e mercato che copriamo. I nomi dei mercati dipendono dallo sport: la maggior parte usa ML, Totals e Spread, il tennis usa Totals (Games) e Spread (Games), e il baseball indica per esteso i primi cinque inning. Chiama /v3/markets?sport=<sport> per i nomi esatti, e /v3/historical/odds senza filtro markets per vedere tutto ciò che contiene un evento.

Avete i movimenti di linea o solo le quote di chiusura?

/v3/odds/movements restituisce la quota di apertura, l'ultima quota e le variazioni intermedie per una linea di mercato. Lo storico è solo pre-match ed è registrato per un elenco fisso di bookmaker, riportato per intero nella documentazione. È disponibile in tutti i piani.

Sono incluse le partite non refertate o annullate?

/v3/historical/events, /v3/historical/events/search e /v3/historical/closing-lines elencano solo eventi refertati, quindi una partita finita che non è ancora stata refertata nel nostro sistema non compare lì. /v3/historical/odds restituisce lo stato dell'evento, quindi controllalo. Per una risposta esplicita su ogni evento, compresi quelli annullati, usa la Bet Settlement API.

Inizia il tuo backtest

I dati storici arrivano con la stessa chiave delle quote live di 450+ bookmaker. Piani da 49 £/mese.