GET odds-by-tournaments

Récupère les cotes de tous les matchs d’un tournoi spécifié.

Endpoint

GET /v4/odds-by-tournaments

Paramètres de requête

• tournamentIds* (string) — Liste d’IDs de tournois séparés par des virgules.
• bookmakers (string) — Docs.GetOddsByTournaments.bookmakers_param
• language (string) — (Optionnel) Code de langue pour les libellés traduits (p. ex. en, de, es). Par défaut : en.
• verbosity (number) — (Optionnel) Niveau de verbosité pour contrôler le niveau de détail de la réponse.
• oddsFormat (string) — (Optionnel) Format des cotes dans la réponse (par ex. decimal, american).

Exemple de requête

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

Exemple de réponse

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

Réponse (200 OK)

En cas de requête réussie, le serveur répond avec un code de statut 200 et renvoie un objet JSON contenant les matchs avec leurs cotes associées.

Champs de premier niveau

• fixtureId (string) — Identifiant unique du match pour lequel récupérer les scores.
• participant1Id (number) — ID du premier participant.
• participant2Id (number) — ID du second participant.
• sportId (number) — Identifiant unique du sport. Cet ID doit correspondre à un sport existant.
• tournamentId (number) — Identifiant unique du tournoi. Cet ID doit correspondre à un tournoi existant.
• seasonId (number|null) — ID de la saison, le cas échéant.
• statusId (number) — Code de statut du match (p. ex. 0 = Avant-match, 1 = Programmé, 2 = En jeu, 3 = Terminé).
• hasOdds (boolean) — Indique si des cotes sont disponibles pour ce match.
• startTime (string) — Heure de début au format ISO 8601.
• trueStartTime (string|null) — Heure de début réelle si différente de l'heure prévue (p. ex. coup d'envoi retardé).
• trueEndTime (string|null) — Heure de fin réelle du match, si disponible.
• updatedAt (string) — Horodatage ISO 8601 de la dernière mise à jour (UTC).
• bookmakerOdds (object) — Cotes regroupées par slug de bookmaker:
  • bookmakerIsActive (boolean) — Indique si ce bookmaker est actuellement actif pour ce match (indique surtout si nous collectons les données de ce bookmaker).
  • bookmakerFixtureId (string) — ID unique du match utilisé par le bookmaker.
  • fixturePath (string) — Lien vers la page de pari du bookmaker pour ce match.
  • suspended (boolean) — Indique si tous les marchés de ce bookmaker sont actuellement suspendus.
  • markets (object) — Objet contenant les IDs de marché comme clés et leurs données correspondantes:
    • bookmakerMarketId (string) — ID de marché interne ou chemin utilisé par le bookmaker.
    • marketActive (boolean) — Indique si ce marché spécifique est actuellement actif.
    • outcomes (object) — Mappage des IDs de résultat vers les données de résultat:
      • players (object) — Mappage des IDs de joueur vers les prix au niveau du joueur:
        • active (boolean) — Indique si les cotes sont actuellement actives.
        • betslip (string|null) — Lien profond vers le coupon ou identifiant, si disponible.
        • bookmakerOutcomeId (string) — Libellé de l’issue côté bookmaker.
        • bookmakerChangedAt (string|null) — Horodatage ISO 8601 du dernier changement signalé par le bookmaker, si fourni.
        • changedAt (string) — Horodatage de la dernière modification des cotes.
        • limit (number|null) — La mise maximale autorisée pour ces cotes.
        • playerName (string|null) — Nom du joueur pour les marchés player props ; null pour les marchés standard.
        • price (number) — Cote au format décimal.
        • priceAmerican (string) — Cote au format américain (p. ex. « -201 », « 171 »).
        • priceFractional (string) — Cote au format fractionnaire (p. ex. « 49/99 »).
        • mainLine (boolean) — Indique si cette ligne est la ligne principale du marché.
        • exchangeMeta (any|null) — Métadonnées supplémentaires pour les bookmakers de type exchange (p. ex. liquidité, prix lay).