GET odds

Recupera quote dettagliate e metadati per uno specifico incontro sportivo da vari bookmaker.

Endpoint

GET /v4/odds

Parametri della richiesta

• fixtureId* (string) — ID univoco dell’incontro
• bookmakers (string) — (Opzionale) Elenco di bookmaker separati da virgola
• oddsFormat (string) — (Opzionale) Formato delle quote desiderato. Opzioni: fractional, decimal, american
• language (string) — (Opzionale) Codice lingua per le etichette tradotte
• verbosity (number) — (Opzionale) Livello di dettaglio della risposta. Un valore più alto restituisce un output più verboso.

Esempio di richiesta

GET /v4/odds?fixtureId=id1000003969653792&bookmakers=pinnacle&language=en&verbosity=3

Risposta di esempio

{
  "fixtureId": "id1000003969653792",
  "participant1Id": 1302,
  "participant2Id": 4872,
  "sportId": 10,
  "tournamentId": 39,
  "seasonId": 130951,
  "statusId": 0,
  "hasOdds": true,
  "startTime": "2026-04-13T17:00:00.000Z",
  "trueStartTime": null,
  "trueEndTime": null,
  "updatedAt": "2026-04-08T18:00:30.461Z",
  "externalProviders": {
    "betradarId": 69653792,
    "mollybetId": "2026-04-13,625,676",
    "opticoddsId": "20260413B49C7BD7",
    "lsportsId": null,
    "txoddsId": null,
    "sofascoreId": 15676262,
    "betgeniusId": 13679074,
    "flashscoreId": "nDaPAq53",
    "pinnacleId": 1627730447,
    "oddinId": null
  },
  "statusName": "Pre-Game",
  "participant1Name": "FC Fredericia",
  "participant1ShortName": "Fredericia",
  "participant1Abbr": "FRE",
  "participant2Name": "Vejle BK",
  "participant2ShortName": "Vejle",
  "participant2Abbr": "VEJ",
  "sportName": "Soccer",
  "tournamentSlug": "superliga",
  "categorySlug": "denmark",
  "categoryName": "Denmark",
  "tournamentName": "Superliga",
  "bookmakerOdds": {
    "pinnacle": {
      "bookmakerIsActive": true,
      "bookmakerFixtureId": "1627730447",
      "fixturePath": "https://www.pinnacle.com/en/e/e/e/1627730447/#all",
      "suspended": false,
      "markets": {
        "10286": {
          "bookmakerMarketId": "1627730447/6020879114/1628099951",
          "marketActive": true,
          "outcomes": {
            "10287": {
              "players": {
                "0": {
                  "active": true,
                  "betslip": null,
                  "bookmakerOutcomeId": "1628099962",
                  "bookmakerChangedAt": null,
                  "changedAt": "2026-04-13T09:00:11.194Z",
                  "limit": 125,
                  "playerName": null,
                  "price": 4.01,
                  "priceAmerican": "301",
                  "priceFractional": "301/100",
                  "mainLine": false,
                  "exchangeMeta": null
                }
              }
            }
          }
        }
      }
    }
  }
}

Dettaglio dei campi della risposta

Campi di primo livello

• fixtureId string — ID interno univoco per l’incontro.
• participant1Id number — L’ID del primo partecipante.
• participant2Id number — L’ID del secondo partecipante.
• sportId number — ID sport
• tournamentId number — ID torneo
• seasonId number|null — (Opzionale) L’ID della stagione.
• statusId number — Lo stato attuale dell’incontro.
• hasOdds boolean — Indica se l’incontro ha quote disponibili.
• startTime string — Orario di inizio in formato ISO 8601.
• trueStartTime string|null — L’orario effettivo di inizio dell’incontro, se disponibile.
• trueEndTime string|null — L’orario effettivo di fine dell’incontro, se disponibile.
• updatedAt string — Orario dell’ultimo aggiornamento in formato ISO 8601.
• statusName string — Stato dell'evento leggibile (p. es. «Pre-Game», «In-Play», «Ended»).
• participant1Name string — Il nome del primo partecipante (nella lingua richiesta).
• participant1ShortName string — Nome breve di visualizzazione del primo partecipante. Tradotto se il parametro language è impostato.
• participant1Abbr string — Abbreviazione di 3 lettere del primo partecipante. Tradotta se il parametro language è impostato.
• participant2Name string — Il nome del secondo partecipante (nella lingua richiesta).
• participant2ShortName string — Nome breve di visualizzazione del secondo partecipante. Tradotto se il parametro language è impostato.
• participant2Abbr string — Abbreviazione di 3 lettere del secondo partecipante. Tradotta se il parametro language è impostato.
• sportName string — Nome dello sport.
• tournamentSlug string — Identificatore del torneo adatto per URL.
• categorySlug string — Slug della categoria di competizione (p. es. «england»).
• categoryName string — Nome visualizzato della categoria (p. es. «England»).
• tournamentName string — Nome completo del torneo (tradotto se il parametro language è impostato).
• externalProviders (object) — ID di provider di terze parti:
  • betradarId (number|null) — (Opzionale) L’ID assegnato da Betradar.
  • mollybetId (string|null) — (Opzionale) L’ID univoco assegnato da Mollybet.
  • opticoddsId (string|null) — (Opzionale) L’ID univoco assegnato da Opticodds.
  • lsportsId (number|null) — (Opzionale) L’ID univoco assegnato da LSports.
  • txoddsId (number|null) — (Opzionale) L’ID univoco assegnato da TXOdds.
  • sofascoreId (number|null) — (Opzionale) L’ID assegnato da Sofascore.
  • betgeniusId (number|null) — (Opzionale) L’ID assegnato da Betgenius.
  • flashscoreId (string|null) — (Opzionale) L’ID assegnato da Flashscore.
  • pinnacleId (number|null) — (Opzionale) L’ID assegnato da Pinnacle.
  • oddinId (number|null) — (Opzionale) L’ID assegnato da Oddin.

Oggetto bookmakerOdds

• bookmakerIsActive boolean — Indica se questo bookmaker è attualmente attivo per questo evento (di solito indica se raccogliamo dati da questo bookmaker).
• bookmakerFixtureId string — Identificatore dell'evento proprio del bookmaker.
• fixturePath string — URL diretto all'evento sul sito del bookmaker.
• suspended boolean — Indica se tutti i mercati per questo bookmaker sono attualmente sospesi.
• markets object — Oggetto contenente gli ID dei mercati come chiavi e i relativi dati di mercato:
  • bookmakerMarketId string — Identificatore interno del mercato del bookmaker.
  • marketActive boolean — Indica se questo specifico mercato è attualmente attivo.
  • outcomes object — Mappa degli ID risultato verso i dati del risultato:
    • players object — Mappa degli ID giocatore verso i prezzi a livello di giocatore:
      • active boolean — Indica se questa selezione è attualmente offerta.
      • betslip string|null — Deep-link alla schedina o identificatore, se disponibile.
      • bookmakerOutcomeId string — Identificatore del risultato del bookmaker (p. es. «3.5/under», «home»).
      • bookmakerChangedAt string|null — Timestamp ISO 8601 dell'ultima modifica segnalata dal bookmaker, se fornito.
      • changedAt string — Timestamp ISO 8601 dell'ultima modifica registrata nel nostro sistema.
      • limit number|null — Importo massimo di scommessa consentito per questa selezione.
      • playerName string|null — Nome del giocatore per i mercati player props; null per i mercati standard.
      • price number — Quote in formato decimale.
      • priceAmerican string — Quote in formato americano (p. es. «-201», «171»).
      • priceFractional string — Quote in formato frazionario (p. es. «49/99»).
      • mainLine boolean — Indica se questa è la linea principale del mercato.
      • exchangeMeta any|null — Metadati aggiuntivi per i bookmaker di tipo exchange (p. es. liquidità, prezzo lay).