Dati e licenza d'uso

Cosa contiene il feed, come trattiamo le quote e cosa puoi verificare da solo. Quasi ogni affermazione di questa pagina si controlla da un endpoint pubblico, senza chiave.

—chiavi nel feedcon quote adesso
—sportnel palinsesto di adesso
—leghenel palinsesto di adesso
—eventinel palinsesto di adesso
—marchi copertiper regione, sotto

Questi conteggi li calcola il browser dal feed di adesso, con GET /api/v1/leagues e GET /api/v1/coverage (pubblici, senza chiave): nessun numero è scritto a mano nella pagina.

Contenuto

Cosa contiene il feed

Il feed contiene le quote dei bookmaker coperti, normalizzate in uno schema unico. Ogni quota resta attribuita al book a cui appartiene, con il suo last_update, e la freschezza di ogni book è misurata e pubblicata sulla pagina di stato. Alcuni book internazionali hanno una cadenza di aggiornamento propria, misurata nella loro riga della pagina di stato.

GET/api/v1/coveragepubblico

Marchi per regione

—
Italia
—
Stati Uniti
—
Regno Unito
—
Resto del mondo
—

Quante insegne copri. Le corsie di mercato dedicate rientrano sotto il loro marchio.

GET/api/v1/bookmakerscon chiave

Chiavi interrogabili

—

Ogni chiave attiva nel feed con country, playable_it, is_exchange e source (tipo di canale del listino). Le corsie di mercato dedicate, come <marchio>-corners, sono chiavi a sé: per questo il conteggio non coincide con quello dei marchi.

Il numero qui sopra sono le chiavi con quote nel palinsesto di adesso (/api/v1/leagues, pubblico).

Le due letture non danno lo stesso numero, e non devono: una conta le chiavi che puoi interrogare, l'altra i marchi che stai coprendo. Nessuna corrispondenza uno a uno fra i due conteggi: misurano cose diverse.

Schema

Come le normalizziamo

  • event_id deterministico. Lo stesso incontro ha lo stesso id su tutti i mercati e per tutta la finestra pre-match: è così che confrontiamo i book tra loro, senza abbinamenti euristici.
  • Schema stabile e versionato. Il contratto è in OpenAPI 3.1: la forma interna del motore non arriva mai al client.
  • Tutti i mercati del book. Per ogni evento esponiamo tutti i mercati che il book quota (esito, under/over, handicap, risultato esatto, primo tempo/finale, combinazioni e mercati propri del book come other:<etichetta>), non solo i principali.
  • Nessuna fusione arbitraria dei book. Ogni chiave del feed resta una chiave e la risposta non fonde marchi diversi in un'unica riga: se ti serve raggrupparli, lo decidi tu. L'unico accorpamento sta nei conteggi per marchio di /api/v1/coverage, dove le corsie di mercato dedicate (<marchio>-corners) rientrano sotto la loro insegna.

Verificabile: GET /api/v1/leagues mostra sport e leghe, con il numero di eventi e di book del palinsesto di adesso.

Qualità

Freschezza e correttezza

  • Il timbro è dell'ultima lettura riuscita. Ogni quota porta il suo last_update (ISO 8601): un book in errore non mostra mai un dato vecchio con un orario fresco.
  • La distribuzione vera è pubblica. p50, p95 e p99 dell'età delle quote che ricevi, adesso e sulle 24 ore, sono sulla pagina di stato, misurati sullo snapshot servito; accanto, book per book, l'ultima lettura nel motore. Misurati, non dichiarati.
  • Non inventiamo dati. Una linea o un handicap il cui segno non si ricava con certezza viene scartato, non indovinato: così si evitano falsi arbitraggi.
  • Non tutto diventa arbitraggio. I mercati non confrontabili fra book (other:*, per giocatore, totali asiatici) sono esposti come dato ma mai promossi ad arbitraggio.
  • Nessun filtro finto. Un parametro di query sconosciuto risponde 400 con l'elenco di quelli ammessi su quell'endpoint (e il suggerimento, se è un refuso), mai 200 con il feed non filtrato. L'errore non consuma quota.
Copertura

Copertura e stagionalità

Non abbiamo una lista di leghe che seguiamo o escludiamo: se un book quota un evento, lo vediamo. Quali mercati compaiono dipende dalla stagione: a campionati fermi il palinsesto del calcio si riduce alle amichevoli, e torna pieno alla ripresa. Il conteggio vero, momento per momento, è su /api/v1/leagues e sulla pagina di stato.

Licenze

Licenza e ridistribuzione

Cosa puoi fare con i dati dipende da chi li vede e da cosa ci costruisci sopra. È un vincolo centrale per un SaaS, non una nota a piè di pagina.

  • Uso interno Modelli, bot, analisi e strumenti tuoi, usati da te o dal tuo team. Incluso in tutti i piani
  • Mostrare le quote ai tuoi utenti Dentro un tuo prodotto o SaaS: ricerca pre-match, confronto, calcolatori, workflow. Serve a mostrare le quote, non ad altro. Enterprise con Redistribuzione Display, non i piani standard
  • Arbitraggio e value betting Individuare, calcolare o vendere surebet e opportunità di valore: la licenza Display non lo copre. Surebet API o White Label

Il testo completo è nei Termini di servizio e nella Licenza Enterprise e di Redistribuzione.

Assistenza

Scrivici a [email protected] o apri un ticket: risponde una persona, via email. Un problema grave viene preso in carico entro 4 ore lavorative (obiettivo); i piani a pagamento hanno la priorità.