GET historical-odds

Endpoint

GET /v4/historical-odds

Anforderungsparameter

• fixtureId* (string) — Fixture-ID, um historische Quoten abzurufen.
• bookmakers* (string) — Komma-getrennte Liste von Buchmacher-Slugs (max 3), um die Ergebnisse zu filtern. Beispiel: pinnacle,bet365
• id (number) — (Optional) Die eindeutige ID eines bestimmten historischen Quoten-Eintrags zum Filtern.
• playerId (number) — (Optional) Die playerId, die mit den Quoten verknüpft ist, um die Ergebnisse einzugrenzen.
• outcomeId (number) — (Optional) Die outcomeId, um die Quoten für ein bestimmtes Ergebnis zu filtern.
• active (boolean) — (Optional) Filtern basierend darauf, ob der Quoten-Eintrag derzeit aktiv ist.

Beispielanfrage

GET /v4/historical-odds?fixtureId=id1000000758265379

Beispielantwort

{
  "fixtureId": "id1000000758265379",
  "bookmakers": {
    "pinnacle": {
      "markets": {
        "101": {
          "outcomes": {
            "101": {
              "players": {
                "0": [
                  {
                    "createdAt": "2025-04-16T21:12:10.506331+00:00",
                    "price": 9.11,
                    "limit": 1191.25,
                    "active": false,
                    "exchangeMeta": null
                  },
                  {
                    "createdAt": "2025-04-16T20:50:58.321847+00:00",
                    "price": 9.11,
                    "limit": 1191.25,
                    "active": true,
                    "exchangeMeta": null
                  }
                ]
              }
            }
          }
        },
        "10168": {
          "outcomes": {
            "10168": {
              "players": {
                "0": [
                  {
                    "createdAt": "2025-04-16T20:16:45.057806+00:00",
                    "price": 1.729,
                    "limit": 13072.7023319616,
                    "active": false,
                    "exchangeMeta": null
                  },
                  {
                    "createdAt": "2025-04-16T20:16:18.597131+00:00",
                    "price": 1.729,
                    "limit": 13072.7023319616,
                    "active": true,
                    "exchangeMeta": null
                  },
                  {
                    "createdAt": "2025-04-16T20:15:51.441377+00:00",
                    "price": 1.699,
                    "limit": 13633.7625178827,
                    "active": true,
                    "exchangeMeta": null
                  }
                ]
              }
            }
          }
        }
      }
    }
  }
}

Antwort (200 OK)

Bei einer erfolgreichen Anfrage antwortet der Server mit einem Statuscode 200 und gibt eine Map von fixtureId zu verschachtelten Buchmacher-Quoten-Historie zurück..

• bookmakers (object) — Quoten gruppiert nach Buchmacher-Slug
  • markets (object) — Jede Begegnung enthält Marktobjekte mit Ergebnissen.
  • outcomes (object) — Ergebnis-IDs mit Spieldaten.
  • players (object) — Spieler mit Quoten-Daten, die enthalten:
    • id (number) — Die eindeutige Kennung für den historischen Quoten-Eintrag.
    • createdAt (string) — Der Zeitstempel, als der historische Quoten-Eintrag erstellt wurde.
    • price (number) — Der Preis (Quoten), der angeboten wird.
    • limit (number) — Der maximal erlaubte Einsatz für die Quoten.
    • active (boolean) — Ob die Quoten derzeit aktiv sind.
    • exchangeMeta (object|null) — Exchange-Metadaten, falls zutreffend, einschließlich Back- und Lay-Preisen.