⚠ Annonce importante concernant OddsPapi v4

Maintenance programmée le lundi 13 février à partir de 1h00 CET. Durée estimée : 1 heure

Avec cette maintenance, nous vous apportons des améliorations en stabilité, temps de réponse et plus de fonctionnalités. Plus d’informations à suivre.

IMPORTANT ! Changements potentiellement incompatibles à venir

Les endpoints ne supporteront plus le paramètre oddsFormat, à la place tous les formats de cotes seront retournés dans les réponses. Ce changement peut être incompatible si vous utilisez actuellement un oddsFormat différent de decimal.

Format de réponse actuel :

GET /v4/odds?fixtureId=id1000017868214572&oddsFormat=american
{
   ... other fields
   "price": "-100"
   ... other fields
}

Nouveau format de réponse (après le 13 février 1h00 CET)

GET /v4/odds?fixtureId=id1000017868214572
{
   ... other fields
   "price": 2.00,
   "priceAmerican": "-100",
   "priceFractional": "1/1",
   ... other fields
}

Documentation de l’API de cotes sportives OddsPapi

Cette documentation vous fournit tout ce dont vous avez besoin pour commencer à utiliser l'API de cotes sportives OddsPapi — un service de données sportives en temps réel offrant des cotes de paris en direct, des cotes d'avant-match, des paris sur les performances des joueurs, des totaux, des écarts et des données historiques de cotes provenant de plus de 300 bookmakers internationaux dans plus de 60 sports. En quelques minutes seulement, vous apprendrez à vous authentifier avec votre clé API, à demander des tournois et des calendriers de matchs, à récupérer les cotes des bookmakers et à suivre en temps réel l'évolution des cotes grâce à notre flux WebSocket à faible latence.

Étape 1 – Obtenez votre clé API

Get your API key in your account settings

Étape 2 – Obtenez les tournois pour un sport

Get the list of tournaments for your favorite sports

Détails ici

GET/v4/tournaments?sportId=10&apiKey={{YOUR_API_KEY}}

curl "https://api.oddspapi.io/v4/tournaments?sportId=10&apiKey={{YOUR_API_KEY}}"

[
  {
    "tournamentId": 17,
    "tournamentSlug": "premier-league",
    "tournamentName": "Premier League",
    "categorySlug": "england",
    "categoryName": "England",
    "futureFixtures": 231,
    "upcomingFixtures": 0,
    "liveFixtures": 0
  },
  {
    "tournamentId": 8,
    "tournamentSlug": "laliga",
    "tournamentName": "LaLiga",
    "categorySlug": "spain",
    "categoryName": "Spain",
    "futureFixtures": 229,
    "upcomingFixtures": 0,
    "liveFixtures": 0
  },
  "{ /* more tournaments... */ }"
]

Étape 3 – Obtenez les prochains matchs et cotes par tournoi

Get the tournaments ids from step 2 and separate them with commas to get a list of upcoming fixtures and odds from a bookmaker

Use the oddsFormat parameter to show odds in either decimal or American format

Détails ici

GET/v4/odds-by-tournaments?bookmaker=pinnacle&tournamentIds=17,8&apiKey={{YOUR_API_KEY}}

curl "https://api.oddspapi.io/v4/odds-by-tournaments?bookmaker=pinnacle&tournamentIds=17,8&apiKey={{YOUR_API_KEY}}"

[
  {
    "fixtureId": "id1000001764618978",
    "participant1Id": 3,
    "participant2Id": 35,
    "sportId": 10,
    "tournamentId": 17,
    "seasonId": 130281,
    "statusId": 0,
    "hasOdds": true,
    "startTime": "2025-12-08T20:00:00.000Z",
    "trueStartTime": null,
    "trueEndTime": null,
    "updatedAt": "2025-12-02T08:01:48.812Z",
    "bookmakerOdds": {
      "pinnacle": {
        "bookmakerIsActive": true,
        "bookmakerFixtureId": "1620599468",
        "fixturePath": "https://www.pinnacle.com/en/e/e/e/1620599468/#all",
        "markets": {
          "101": {
            "outcomes": {
              "101": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "home",
                    "changedAt": "2025-12-07T22:50:48.515996+00:00",
                    "limit": 5000,
                    "playerName": null,
                    "price": 5.01,
                    "exchangeMeta": {}
                  }
                }
              },
              "102": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "draw",
                    "changedAt": "2025-12-07T22:50:48.516257+00:00",
                    "limit": 5000,
                    "playerName": null,
                    "price": 4.32,
                    "exchangeMeta": {}
                  }
                }
              },
              "103": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "away",
                    "changedAt": "2025-12-07T22:50:48.516384+00:00",
                    "limit": 7704,
                    "playerName": null,
                    "price": 1.649,
                    "exchangeMeta": {}
                  }
                }
              }
            },
            "bookmakerMarketId": "line/29/1980/1620128138/3377661430/0/moneyline"
          },
          "104": {
            "outcomes": {
              "104": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "1620599418",
                    "changedAt": "2025-12-07T21:33:08.962871+00:00",
                    "limit": 705,
                    "playerName": null,
                    "price": 1.709,
                    "exchangeMeta": {}
                  }
                }
              },
              "105": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "1620599419",
                    "changedAt": "2025-12-07T21:33:08.963137+00:00",
                    "limit": 500,
                    "playerName": null,
                    "price": 2.2,
                    "exchangeMeta": {}
                  }
                }
              }
            },
            "bookmakerMarketId": "1620128138/5608638792/1620599417"
          }
        }
      }
    }
  },
  {
    "fixtureId": "id1000000861624232",
    "participant1Id": 2820,
    "participant2Id": 2849,
    "sportId": 10,
    "tournamentId": 8,
    "seasonId": 130805,
    "statusId": 0,
    "hasOdds": true,
    "startTime": "2025-12-08T20:00:00.000Z",
    "trueStartTime": null,
    "trueEndTime": null,
    "updatedAt": "2025-11-30T14:00:59.994Z",
    "bookmakerOdds": {
      "pinnacle": {
        "bookmakerIsActive": true,
        "bookmakerFixtureId": "1620613130",
        "fixturePath": "https://www.pinnacle.com/en/e/e/e/1620613130/#all",
        "markets": {
          "101": {
            "outcomes": {
              "101": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "home",
                    "changedAt": "2025-12-07T20:45:17.225169+00:00",
                    "limit": 9986,
                    "playerName": null,
                    "price": 1.751,
                    "exchangeMeta": {}
                  }
                }
              },
              "102": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "draw",
                    "changedAt": "2025-12-07T20:45:17.225297+00:00",
                    "limit": 7500,
                    "playerName": null,
                    "price": 3.89,
                    "exchangeMeta": {}
                  }
                }
              },
              "103": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "away",
                    "changedAt": "2025-12-07T20:45:17.225365+00:00",
                    "limit": 7500,
                    "playerName": null,
                    "price": 4.81,
                    "exchangeMeta": {}
                  }
                }
              }
            },
            "bookmakerMarketId": "line/29/2196/1620122243/3377596534/0/moneyline"
          },
          "104": {
            "outcomes": {
              "104": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "1620613118",
                    "changedAt": "2025-12-07T20:45:15.476236+00:00",
                    "limit": 848,
                    "playerName": null,
                    "price": 1.884,
                    "exchangeMeta": {}
                  }
                }
              },
              "105": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "1620613119",
                    "changedAt": "2025-12-07T20:45:15.476405+00:00",
                    "limit": 773,
                    "playerName": null,
                    "price": 1.97,
                    "exchangeMeta": {}
                  }
                }
              }
            },
            "bookmakerMarketId": "1620122243/5608474224/1620613117"
          }
        }
      }
    }
  },
  "{ /* more fixtures... */ }"
]

Hôte

Toutes les requêtes utilisent l’hôte https://api.oddspapi.io

Autorisation

Tous les endpoints nécessitent qu’une clé API soit passée en paramètre de requête :

Paramètre	Clé	Valeur
Autorisation	apiKey	{{YOUR_API_KEY}}

Nous contacter

Si vous avez des questions, besoin d’aide ou souhaitez signaler un problème, n’hésitez pas à nous contacter à [email protected].

Page suivanteGET account