Mercato italiano · licenze ADM

API quote dei bookmaker italiani (ADM)

Q: Come sono strutturate le quote?

JSON normalizzato con un event_id deterministico condiviso da tutti i mercati dello stesso incontro, e un last_update per ogni quota di ogni book. Un solo endpoint (GET /api/v1/odds) restituisce tutte le quote cross-book per evento e mercato.

Le quote di oltre 40 concessionari con licenza ADM in un unico JSON normalizzato, insieme a più di 160 book esteri ed exchange: un solo feed, una sola quota mensile.

Crea una chiave gratis Documentazione

Free: 500 richieste al mese, senza carta
Sandbox senza chiave

Il contesto

Il mercato italiano, in un feed solo

Se hai provato a costruire uno strumento sul mercato italiano — un comparatore, un bot, un modello, una dashboard — probabilmente hai scoperto il conto: le API di quote globali nascono per gli operatori statunitensi, britannici e offshore, e dei concessionari ADM ne coprono una parte, spesso con un prezzo per ogni book in più. Per confrontare il mercato regolamentato italiano servono tutti, insieme.

odss-api nasce per questo: le quote di oltre 40 operatori con licenza ADM, normalizzate in un JSON stabile, insieme ai book di riferimento internazionali usati come metro «sharp», fra più di 160 book esteri. Ogni quota è attribuita al suo book e porta il suo last_update; l'età delle quote che ricevi è misurata e pubblica sulla pagina di stato.

Copertura

Bookmaker coperti

Oltre 40 concessionari con licenza ADM, più book di riferimento internazionali ed exchange. Non pubblichiamo un muro di marchi: la lista che conta è quella del feed, adesso.

Ogni book nella risposta di GET /api/v1/bookmakers porta questi campi:

Campi di ogni book nella risposta di /api/v1/bookmakers
Campo	Cosa indica
`key`	L'identificativo del book: è il valore da passare nel parametro `bookmakers=` di `/api/v1/odds`.
`country`	Il paese della licenza (codice ISO 3166-1, per esempio `IT`), oppure `world` quando al book non è attribuito un paese.
`playable_it`	`true` solo per i book con licenza ADM, cioè giocabili dall'Italia.
`is_exchange`	`true` per gli exchange.
`source`	Tipo di canale del listino: `direct` \| `partner_feed`.

L'elenco dei book attivi

GET /api/v1/bookmakers richiede una chiave

Richiede una chiave API (la Free si genera in un minuto, senza carta) e non accetta nessun parametro: i campi della tabella si leggono nella risposta, non si passano nella URL.

Le quote di alcuni book soltanto

GET /api/v1/odds?bookmakers=…

Per filtrare le quote su un sottoinsieme di book si usa il parametro bookmakers= di /api/v1/odds, con le key separate da virgole.

Il conteggio per regione

GET /api/v1/coverage pubblico, senza chiave

Conta ogni operatore una volta, con le corsie di mercato dedicate sotto il marchio, come /bookmakers (dove le chiavi di quelle corsie stanno in feed_keys).

Formato

Come sono strutturate le quote

Un solo endpoint. GET /api/v1/odds restituisce tutte le quote cross-book per evento e mercato, filtrabili per sport, league, market e bookmakers (i nomi esatti dei parametri: uno sconosciuto risponde 400, non viene ignorato).
event_id deterministico. Lo stesso incontro ha lo stesso id su tutti i book e per tutta la finestra pre-match: il confronto tra operatori è nativo, non euristico.
last_update per quota. Ogni quota di ogni book porta il timbro del suo ultimo aggiornamento riuscito. La freschezza è un dato, non una promessa.
Anche i mercati secondari. Esito, under/over, handicap, risultato esatto, primo tempo/finale e mercati specifici dei singoli book, non solo i principali.

Richiesta · feed vero, con chiave

curl -G https://odss-api.com/api/v1/odds \
  -H "x-api-key: odss_live_..." \
  -d sport=calcio -d market=1x2 \
  -d bookmakers=sisal,snai,goldbet

La chiave si passa nell'header x-api-key. Per provare la forma della risposta senza chiave c'è il sandbox /api/v1/mock/odds, con book finti.

Campi di ogni recordapplication/json

event_ideventcommence_timemarketbookmakers[].keyoutcomeslast_update

Confronto

odss-api e le API globali, a confronto

Confronto tra odss-api e le API di quote globali
Caratteristica	odss-api	API globali
Bookmaker ADM italiani	40+ nel feed	Pochi, spesso pagati a book
bet365 / Pinnacle	Pinnacle sì, bet365 solo live	Parziale
Come si paga	Per account (quota/mese)	Spesso per book o a crediti
Cross-book	event_id deterministico	Spesso euristico
Freschezza	last_update per book, età servita pubblica	Spesso non esposta
Piano gratuito	Free per sempre	Variabile

Confronto con la media dei provider globali valutati (2026). Le voci del nostro lato sono verificabili dagli endpoint pubblici e dalla pagina di stato.

Freschezza

Quanto sono fresche le quote?

Non lo dichiariamo: lo misuriamo. L'età delle quote che ricevi — p50 e p95, adesso e sulle ultime 24 ore, misurati sullo snapshot che l'API sta servendo — è pubblicata sulla pagina di stato, che si aggiorna ogni 30 secondi: il numero di oggi lo leggi lì, non in un testo che invecchia. I target che pubblichiamo sono p50 ≤ 15 minuti e p95 ≤ 60 minuti (vedi SLA), con la cattura di tutti i mercati. Ogni quota nelle risposte porta il suo last_update: giudichi tu, dato per dato.

Piano Free

Prova gratis, senza carta

Il piano Free include 500 richieste al mese con la stessa copertura dei piani a pagamento: stessi bookmaker ADM, stesso schema JSON, stessa freschezza. La chiave si genera in un minuto dalla dashboard, senza inserire una carta.

Quando serve più volume: Hobby 19 €/mese + IVA (10.000 richieste), Starter 79 €/mese + IVA (100.000), Pro 159 €/mese + IVA (500.000), Enterprise configurabile da 199 €/mese + IVA. I prezzi sono al netto dell'IVA: per un privato italiano Hobby, Starter e Pro diventano 23,18 €, 96,38 € e 193,98 €; per le imprese di altri Stati UE con partita IVA valida vale l'inversione contabile (imposta 0) e per i clienti extra-UE l'operazione è fuori campo IVA italiana. Il totale è sempre indicato nel riepilogo del checkout, che confermi prima dell'ordine (§4 dei Termini).

Domande

Domande frequenti

Quali bookmaker italiani copre l'API?

Oltre 40 concessionari con licenza ADM, più book di riferimento internazionali ed exchange. Non pubblichiamo un elenco di marchi: l'elenco dei book attivi, con i campi country, playable_it, is_exchange e source, è su GET /api/v1/bookmakers, che richiede una chiave API (la Free si genera in un minuto, senza carta). Senza chiave sono pubblici GET /api/v1/leagues e GET /api/v1/coverage.

Le API di quote globali hanno i book italiani?

Alcune ne hanno una parte, spesso con un prezzo per ogni book in più. odss-api mette 40+ concessionari ADM e oltre 160 book esteri in un solo feed e in una sola quota mensile, in un unico schema JSON normalizzato, con ogni quota attribuita al suo book e al suo last_update: lo verifichi su /api/v1/coverage, pubblico e senza chiave.

Come sono strutturate le quote?

JSON normalizzato con un event_id deterministico condiviso da tutti i mercati dello stesso incontro, e un last_update per ogni quota di ogni book. Un solo endpoint (GET /api/v1/odds) restituisce tutte le quote cross-book per evento e mercato.

C'è un piano gratuito?

Sì: il piano Free è per sempre (500 richieste/mese) e ha la stessa copertura dati dei piani a pagamento. La chiave si genera dalla dashboard: servono email, password e i dati di fatturazione, non una carta.

Prova con i tuoi dati.

Il piano Free ha la stessa copertura dei piani a pagamento: così verifichi sui tuoi casi d'uso, senza carta.

Ottieni una chiave gratis

curl https://odss-api.com/api/v1/mock/odds