GET odds

Récupère des cotes détaillées et des métadonnées pour un match sportif donné auprès de différents bookmakers.

Endpoint

GET /v4/odds

Paramètres de requête

• fixtureId* (string) — ID unique du match
• bookmakers (string) — (Optionnel) Liste de bookmakers séparés par des virgules
• oddsFormat (string) — (Optionnel) Format de cotes souhaité. Options: fractional, decimal, american
• language (string) — (Optionnel) Code de langue pour les libellés traduits
• verbosity (number) — (Optionnel) Niveau de détail de la réponse. Une valeur plus élevée renvoie une sortie plus détaillée.

Exemple de requête

GET /v4/odds?fixtureId=id1000003969653792&bookmakers=pinnacle&language=en&verbosity=3

Réponse d’exemple

{
  "fixtureId": "id1000003969653792",
  "participant1Id": 1302,
  "participant2Id": 4872,
  "sportId": 10,
  "tournamentId": 39,
  "seasonId": 130951,
  "statusId": 0,
  "hasOdds": true,
  "startTime": "2026-04-13T17:00:00.000Z",
  "trueStartTime": null,
  "trueEndTime": null,
  "updatedAt": "2026-04-08T18:00:30.461Z",
  "externalProviders": {
    "betradarId": 69653792,
    "mollybetId": "2026-04-13,625,676",
    "opticoddsId": "20260413B49C7BD7",
    "lsportsId": null,
    "txoddsId": null,
    "sofascoreId": 15676262,
    "betgeniusId": 13679074,
    "flashscoreId": "nDaPAq53",
    "pinnacleId": 1627730447,
    "oddinId": null
  },
  "statusName": "Pre-Game",
  "participant1Name": "FC Fredericia",
  "participant1ShortName": "Fredericia",
  "participant1Abbr": "FRE",
  "participant2Name": "Vejle BK",
  "participant2ShortName": "Vejle",
  "participant2Abbr": "VEJ",
  "sportName": "Soccer",
  "tournamentSlug": "superliga",
  "categorySlug": "denmark",
  "categoryName": "Denmark",
  "tournamentName": "Superliga",
  "bookmakerOdds": {
    "pinnacle": {
      "bookmakerIsActive": true,
      "bookmakerFixtureId": "1627730447",
      "fixturePath": "https://www.pinnacle.com/en/e/e/e/1627730447/#all",
      "suspended": false,
      "markets": {
        "10286": {
          "bookmakerMarketId": "1627730447/6020879114/1628099951",
          "marketActive": true,
          "outcomes": {
            "10287": {
              "players": {
                "0": {
                  "active": true,
                  "betslip": null,
                  "bookmakerOutcomeId": "1628099962",
                  "bookmakerChangedAt": null,
                  "changedAt": "2026-04-13T09:00:11.194Z",
                  "limit": 125,
                  "playerName": null,
                  "price": 4.01,
                  "priceAmerican": "301",
                  "priceFractional": "301/100",
                  "mainLine": false,
                  "exchangeMeta": null
                }
              }
            }
          }
        }
      }
    }
  }
}

Détail des champs de la réponse

Champs de premier niveau

• fixtureId string — ID interne unique du match.
• participant1Id number — ID du premier participant.
• participant2Id number — ID du deuxième participant.
• sportId number — ID du sport
• tournamentId number — ID du tournoi
• seasonId number|null — (Optionnel) ID de la saison.
• statusId number — Statut actuel du match.
• hasOdds boolean — Indique si le match a des cotes disponibles.
• startTime string — Heure de début au format ISO 8601.
• trueStartTime string|null — Heure réelle de début du match, si disponible.
• trueEndTime string|null — Heure réelle de fin du match, si disponible.
• updatedAt string — Heure de dernière mise à jour au format ISO 8601.
• statusName string — Statut du match lisible (p. ex. « Pre-Game », « In-Play », « Ended »).
• participant1Name string — Nom du premier participant (dans la langue demandée).
• participant1ShortName string — Nom court d'affichage du premier participant. Traduit si le paramètre language est défini.
• participant1Abbr string — Abréviation de 3 lettres du premier participant. Traduite si le paramètre language est défini.
• participant2Name string — Nom du deuxième participant (dans la langue demandée).
• participant2ShortName string — Nom court d'affichage du second participant. Traduit si le paramètre language est défini.
• participant2Abbr string — Abréviation de 3 lettres du second participant. Traduite si le paramètre language est défini.
• sportName string — Nom du sport.
• tournamentSlug string — Identifiant de tournoi compatible URL.
• categorySlug string — Slug de la catégorie de compétition (p. ex. « england »).
• categoryName string — Nom d'affichage de la catégorie (p. ex. « England »).
• tournamentName string — Nom complet du tournoi (traduit si le paramètre language est défini).
• externalProviders (object) — IDs de fournisseurs tiers:
  • betradarId (number|null) — (Optionnel) ID attribué par Betradar.
  • mollybetId (string|null) — (Optionnel) ID unique attribué par Mollybet.
  • opticoddsId (string|null) — (Optionnel) ID unique attribué par Opticodds.
  • lsportsId (number|null) — (Optionnel) ID unique attribué par LSports.
  • txoddsId (number|null) — (Optionnel) ID unique attribué par TXOdds.
  • sofascoreId (number|null) — (Optionnel) ID attribué par Sofascore.
  • betgeniusId (number|null) — (Optionnel) ID attribué par Betgenius.
  • flashscoreId (string|null) — (Optionnel) ID attribué par Flashscore.
  • pinnacleId (number|null) — (Optionnel) ID attribué par Pinnacle.
  • oddinId (number|null) — (Optionnel) ID attribué par Oddin.

Objet bookmakerOdds

• 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 — Identifiant de match propre au bookmaker.
• fixturePath string — URL directe vers le match sur le site du bookmaker.
• 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 — Identifiant interne du marché chez 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 cette sélection est actuellement proposée.
      • betslip string|null — Lien profond vers le coupon ou identifiant, si disponible.
      • bookmakerOutcomeId string — Identifiant du résultat chez le bookmaker (p. ex. « 3.5/under », « home »).
      • bookmakerChangedAt string|null — Horodatage ISO 8601 du dernier changement signalé par le bookmaker, si fourni.
      • changedAt string — Horodatage ISO 8601 du dernier changement enregistré dans notre système.
      • limit number|null — Mise maximale autorisée pour cette sélection.
      • 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).