Documentação da API de probabilidades esportivas do OddsPapi
Esta documentação fornece tudo o que você precisa para começar a usar a API de Odds Esportivas da OddsPapi — um serviço de dados esportivos em tempo real que oferece odds de apostas ao vivo, odds pré-jogo, apostas em jogadores, totais, spreads e dados históricos de odds de mais de 300 casas de apostas globais em mais de 60 modalidades esportivas. Em poucos minutos, você aprenderá como autenticar com sua chave de API, solicitar torneios e jogos, obter odds de casas de apostas e transmitir movimentações de linhas em tempo real por meio de nosso feed WebSocket de baixa latência.
Passo 1 – Obtenha sua chave de API
Get your API key in your account settings
Passo 2 – Obtenha ligas para um esporte
Get the list of tournaments for your favorite sports
Detalhes aquicurl "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... */ }"
]Passo 3 – Obtenha os próximos eventos e probabilidades por liga
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
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... */ }"
]Host
Todas as requisições usam o host https://api.oddspapi.io
Autorização
Todos os endpoints exigem que uma chave API seja enviada como parâmetro da requisição:
| Parâmetro | Chave | Valor |
|---|---|---|
| Autorização | apiKey | {{YOUR_API_KEY}} |
Fale conosco
Se você tiver dúvidas, precisar de ajuda ou quiser reportar um problema, sinta-se à vontade para falar com a gente em [email protected].