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.
• bookmaker (string) — (Optionnel) Slug du bookmaker à partir duquel renvoyer les cotes.
• 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

Exemple de réponse

[
  {
    "fixtureId": "id1000001761300517",
    "participant1Id": 3,
    "participant2Id": 17,
    "sportId": 10,
    "tournamentId": 17,
    "seasonId": null,
    "externalProviders": {
      "betradarId": 61300517,
      "mollybetId": null,
      "opticoddsId": null,
      "lsportsId": null,
      "txoddsId": null,
      "sofascoreId": null,
      "betgeniusId": 12482853,
      "flashscoreId": null,
      "pinnacleId": 1610924789,
      "oddinId": null
    },
    "statusId": null,
    "hasOdds": true,
    "startTime": "2025-08-16T16:30:00.000Z",
    "trueStartTime": null,
    "trueEndTime": null,
    "updatedAt": "2025-07-14T20:06:02.074Z",
    "participant1Name": "Wolverhampton Wanderers",
    "participant2Name": "Manchester City",
    "sportName": "Soccer",
    "tournamentSlug": "premier-league",
    "categorySlug": "england",
    "categoryName": "England",
    "tournamentName": "Premier League",
    "bookmakerOdds": {
      "pinnacle": {
        "bookmakerFixtureId": "1610924789",
        "fixturePath": "https://www.pinnacle.com/en/e/e/e/1610924789/#all",
        "bookmakerIsActive": true,
        "markets": {
          "101": {
            "bookmakerMarketId": "line/29/1980/3180242530/0/moneyline",
            "outcomes": {
              "101": {
                "players": {
                  "0": {
                    "price": 5.84,
                    "limit": 250,
                    "active": true,
                    "changedAt": "2025-07-17T10:45:56.606Z",
                    "playerId": 0,
                    "bookmakerOutcomeId": "home"
                  }
                }
              },
              "102": {
                "players": {
                  "0": {
                    "price": 4.76,
                    "limit": 250,
                    "active": true,
                    "changedAt": "2025-07-17T10:45:56.606Z",
                    "playerId": 0,
                    "bookmakerOutcomeId": "draw"
                  }
                }
              },
              "103": {
                "players": {
                  "0": {
                    "price": 1.454,
                    "limit": 550.66,
                    "active": true,
                    "changedAt": "2025-07-17T10:45:56.606Z",
                    "playerId": 0,
                    "bookmakerOutcomeId": "away"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
]

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.

• fixtureId(string) — Identifiant unique du match pour lequel récupérer les scores.
• sportId(number) — Identifiant unique du sport. Cet ID doit correspondre à un sport existant.
• tournamentId(string) — Identifiant unique du tournoi. Cet ID doit correspondre à un tournoi existant.
• startTime(string) — Heure de début au format ISO 8601.
• participant1Name(string) — Nom du premier participant (dans la langue demandée).
• participant2Name(string) — Nom du deuxième participant (dans la langue demandée).
• bookmakerOdds (object) — Cotes regroupées par slug de bookmaker:
  • bookmakerFixtureId (string) — ID unique du match utilisé par le bookmaker.
  • fixturePath (string) — Lien vers la page de pari du bookmaker pour ce match.
  • bookmakerIsActive (boolean) — Indique si le bookmaker propose actuellement des cotes pour ce match.
  • markets (object) — Objet contenant les IDs de marché comme clés et leurs données de marché correspondantes:
    • bookmakerMarketId (string) — ID de marché interne ou chemin utilisé par le bookmaker.
    • outcomes (object) — Mapping des IDs d’issue vers leurs données d’issue. Chaque objet d’issue inclut des prix au niveau joueur:
      • players (object) — Chaque issue est associée à un ou plusieurs joueurs pour lesquels des cotes sont proposées.:
        • price (number) — Le prix (cotes) proposé.
        • limit (number) — La mise maximale autorisée pour ces cotes.
        • active (boolean) — Indique si les cotes sont actuellement actives.
        • changedAt (string) — Horodatage de la dernière modification des cotes.
        • playerId (number) — ID du joueur (généralement 0).
        • bookmakerOutcomeId (string) — Libellé de l’issue côté bookmaker.