GET odds-by-tournaments

Recupera le quote per tutti gli incontri in un torneo specificato.

Endpoint

GET /v4/odds-by-tournaments

Parametri della richiesta

• tournamentIds* (string) — Un elenco di ID torneo separati da virgola.
• bookmakers (string) — Docs.GetOddsByTournaments.bookmakers_param
• language (string) — (Opzionale) Codice lingua per le etichette tradotte (p. es. en, de, es). Predefinito: en.
• verbosity (number) — (Opzionale) Il livello di verbosità per controllare il dettaglio della risposta.
• oddsFormat (string) — (Opzionale) Il formato delle quote nella risposta (ad es. decimal, american).

Esempio di richiesta

GET /v4/odds-by-tournaments?tournamentIds=17&bookmakers=pinnacle&language=en&verbosity=3

Esempio di risposta

{
  "fixtureId": "id1000001761301153",
  "participant1Id": 35,
  "participant2Id": 34,
  "sportId": 10,
  "tournamentId": 17,
  "seasonId": 130281,
  "statusId": 0,
  "hasOdds": true,
  "startTime": "2026-04-13T19:00:00.000Z",
  "trueStartTime": null,
  "trueEndTime": null,
  "updatedAt": "2026-04-06T23:17:08.202Z",
  "bookmakerOdds": {
    "pinnacle": {
      "bookmakerIsActive": true,
      "bookmakerFixtureId": "1626291706",
      "fixturePath": "https://www.pinnacle.com/en/e/e/e/1626291706/#all",
      "suspended": false,
      "markets": {
        "1012": {
          "bookmakerMarketId": "line/29/1980/1626291706/56152425451/0/totals",
          "marketActive": true,
          "outcomes": {
            "1012": {
              "players": {
                "0": {
                  "active": true,
                  "betslip": null,
                  "bookmakerOutcomeId": "3.5/over",
                  "bookmakerChangedAt": "2026-04-13T09:24:46.990Z",
                  "changedAt": "2026-04-13T09:24:47.424Z",
                  "limit": 20000,
                  "playerName": null,
                  "price": 2.71,
                  "priceAmerican": "171",
                  "priceFractional": "171/100",
                  "mainLine": false,
                  "exchangeMeta": null
                }
              }
            },
            "1013": {
              "players": {
                "0": {
                  "active": true,
                  "betslip": null,
                  "bookmakerOutcomeId": "3.5/under",
                  "bookmakerChangedAt": "2026-04-13T09:11:04.603Z",
                  "changedAt": "2026-04-13T09:11:05.099Z",
                  "limit": 40241,
                  "playerName": null,
                  "price": 1.497,
                  "priceAmerican": "-201",
                  "priceFractional": "49/99",
                  "mainLine": false,
                  "exchangeMeta": null
                }
              }
            }
          }
        }
      }
    }
  }
}

Risposta (200 OK)

In caso di richiesta andata a buon fine, il server risponde con un codice di stato 200 e restituisce un oggetto JSON contenente gli incontri con le rispettive quote.

Campi di primo livello

• fixtureId (string) — L’identificatore univoco dell’incontro per il quale recuperare i punteggi.
• participant1Id (number) — ID del primo partecipante.
• participant2Id (number) — ID del secondo partecipante.
• sportId (number) — L’identificatore univoco dello sport. Questo ID deve corrispondere a uno sport esistente.
• tournamentId (number) — L’identificatore univoco del torneo. Questo ID deve corrispondere a un torneo esistente.
• seasonId (number|null) — ID della stagione, se applicabile.
• statusId (number) — Codice di stato dell'evento (p. es. 0 = Pre-partita, 1 = Programmato, 2 = In gioco, 3 = Concluso).
• hasOdds (boolean) — Indica se sono disponibili dati di quote per questo evento.
• startTime (string) — Orario di inizio in formato ISO 8601.
• trueStartTime (string|null) — Orario di inizio effettivo se diverso da quello programmato (p. es. fischio di inizio ritardato).
• trueEndTime (string|null) — Orario di fine effettivo dell'evento, se disponibile.
• updatedAt (string) — Timestamp ISO 8601 dell'ultimo aggiornamento (UTC).
• bookmakerOdds (object) — Quote raggruppate per slug del bookmaker:
  • bookmakerIsActive (boolean) — Indica se questo bookmaker è attualmente attivo per questo evento (di solito indica se raccogliamo dati da questo bookmaker).
  • bookmakerFixtureId (string) — ID univoco dell’incontro usato dal bookmaker.
  • fixturePath (string) — Link alla pagina di scommessa del bookmaker per l’incontro.
  • 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) — ID mercato interno o percorso usato dal 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 la quota è attualmente attiva.
        • betslip (string|null) — Deep-link alla schedina o identificatore, se disponibile.
        • bookmakerOutcomeId (string) — Etichetta dell’esito lato bookmaker.
        • bookmakerChangedAt (string|null) — Timestamp ISO 8601 dell'ultima modifica segnalata dal bookmaker, se fornito.
        • changedAt (string) — Timestamp dell’ultima modifica della quota.
        • limit (number|null) — La puntata massima consentita per quella quota.
        • 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).