GET odds-by-tournaments

Ruft die Quoten für alle Spiele in einem bestimmten Turnier ab.

Endpoint

GET /v4/odds-by-tournaments

Anforderungsparameter

  • tournamentIds* (string) Eine durch Kommas getrennte Liste von Turnier-IDs.
  • bookmakers (string) Docs.GetOddsByTournaments.bookmakers_param
  • language (string) (Optional) Sprachcode für übersetzte Bezeichnungen (z. B. en, de, es). Standard ist en.
  • verbosity (number) (Optional) Der Detaillierungsgrad, um die Details der Antwort zu steuern.
  • oddsFormat (string) (Optional) Format der Quoten in der Antwort. (z.B. decimal, american).

Beispielanfrage

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

Beispielantwort

{
  "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
                }
              }
            }
          }
        }
      }
    }
  }
}

Antwort (200 OK)

Bei einer erfolgreichen Anfrage antwortet der Server mit einem Statuscode 200 und gibt ein JSON-Objekt mit Spielen und ihren zugehörigen Quoten zurück.

Top-Level-Felder

  • fixtureId (string) Die eindeutige Kennung für das Spiel.
  • participant1Id (number) ID des ersten Teilnehmers.
  • participant2Id (number) ID des zweiten Teilnehmers.
  • sportId (number)Die eindeutige Kennung für den Sport. Diese ID muss einem vorhandenen Sport entsprechen.
  • tournamentId (number)Die eindeutige Kennung für das Turnier. Diese ID muss einem vorhandenen Turnier entsprechen.
  • seasonId (number|null) ID der Saison, falls zutreffend.
  • statusId (number) Statuscode des Spiels (z. B. 0 = Vor dem Spiel, 1 = Geplant, 2 = Live, 3 = Beendet).
  • hasOdds (boolean) Ob für dieses Spiel Quoten verfügbar sind.
  • startTime (string)ISO 8601 Startzeit.
  • trueStartTime (string|null) Tatsächliche Startzeit, falls von der geplanten abweichend (z. B. verspäteter Anpfiff).
  • trueEndTime (string|null) Tatsächliche Endzeit des Spiels, falls verfügbar.
  • updatedAt (string) ISO-8601-Zeitstempel der letzten Aktualisierung (UTC).
  • bookmakerOdds (object) Quoten gruppiert nach Buchmacher-Slug:
    • bookmakerIsActive (boolean) Ob dieser Buchmacher derzeit für dieses Spiel aktiv ist (gibt hauptsächlich an, ob wir Daten von diesem Buchmacher erfassen).
    • bookmakerFixtureId (string) Eindeutige Spiel-ID, die vom Buchmacher verwendet wird.
    • fixturePath (string) Link zur Wettseite des Buchmachers für das Spiel.
    • suspended (boolean) Ob alle Märkte für diesen Buchmacher derzeit ausgesetzt sind.
    • markets (object) Objekt mit Markt-IDs als Schlüsseln und den entsprechenden Marktdaten:
      • bookmakerMarketId (string) Interne Markt-ID oder Pfad, der vom Buchmacher verwendet wird.
      • marketActive (boolean) Ob dieser spezifische Markt derzeit aktiv ist.
      • outcomes (object) Zuordnung von Ergebnis-IDs zu Ergebnisdaten:
        • players (object) Zuordnung von Spieler-IDs zu Preisen auf Spielerebene:
          • active (boolean) Ob die Quoten derzeit aktiv sind.
          • betslip (string|null) Wettschein-Deeplink oder Kennung, falls verfügbar.
          • bookmakerOutcomeId (string) Bezeichner des Buchmachers für das Ergebnis.
          • bookmakerChangedAt (string|null) ISO-8601-Zeitstempel der letzten gemeldeten Änderung des Buchmachers, falls vorhanden.
          • changedAt (string) Zeitstempel der letzten Änderung der Quoten.
          • limit (number|null) Der maximal erlaubte Einsatz für die Quoten.
          • playerName (string|null) Spielername bei Spieler-Wettmärkten; null bei Standardmärkten.
          • price (number) Quoten im Dezimalformat.
          • priceAmerican (string) Quoten im amerikanischen Format (z. B. „-201", „171").
          • priceFractional (string) Quoten im Bruchformat (z. B. „49/99").
          • mainLine (boolean) Ob dies die Haupt-/Standardlinie für den Markt ist.
          • exchangeMeta (any|null) Zusätzliche Metadaten für börsenbasierte Buchmacher (z. B. Liquidität, Lay-Quote).

Notizen

  • Endpunkt-Abkühlung (Ratenbegrenzung): 1000ms
  • Wenn der Parameter „bookmakers" nicht angegeben ist, werden Quoten aller verfügbaren Buchmacher berücksichtigt.
  • Alle Zeitstempel sind in UTC (ISO 8601).
  • Alle drei Preisformate (price, priceAmerican, priceFractional) werden unabhängig vom Query-Parameter oddsFormat zurückgegeben.
Vorherige SeiteGET odds
Nächste SeiteGET historical odds
Problem melden
OddsPapi | Docs GET odds by tournaments