A API de liquidação de apostas que entrega o veredito
Você tem uma lista de apostas e quer saber quais ganharam. Envie o evento, o mercado, a linha e o lado, e receba ganha, perdida, anulada, meio ganha ou meio perdida, calculado a partir do placar final em 172 mercados de 21 esportes.
Incluída em todos os planos pagos. Cada chamada conta como uma requisição.
- Mercados
- 172
- Esportes
- 21
- Apostas por requisição
- 50
- Endpoints
- 2
Liquide três apostas em uma única requisição
Esta partida terminou 3-2 nos 90 minutos e 3-3 após a prorrogação. No futebol a liquidação vale pelos 90 minutos, então o moneyline do mandante ganhou, e basis mostra o placar usado.
curl -X POST "https://api.odds-api.io/v3/settlements/grade?apiKey=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"selections": [
{ "ref": "bet-1", "eventId": 74919888, "market": "ML", "side": "home" },
{ "ref": "bet-2", "eventId": 74919888, "market": "Spread", "hdp": -0.75, "side": "home" },
{ "ref": "bet-3", "eventId": 74919888, "market": "Totals", "hdp": 5.5, "side": "over" }
]
}'{
"grades": [
{ "ref": "bet-1", "eventId": 74919888, "result": "won", "reason": null, "final": true,
"basis": { "scope": "regulation", "home": 3, "away": 2 } },
{ "ref": "bet-2", "eventId": 74919888, "result": "half_won", "reason": null, "final": true,
"basis": { "scope": "regulation", "home": 3, "away": 2 } },
{ "ref": "bet-3", "eventId": 74919888, "result": "lost", "reason": null, "final": true,
"basis": { "scope": "regulation", "home": 3, "away": 2 } }
]
}Como funciona a liquidação de apostas
Dois endpoints. GET /v3/settlements diz o que aconteceu em até 50 eventos. POST /v3/settlements/grade diz se as suas apostas ganharam.
- 1
Guarde a aposta
Quando uma aposta é feita, guarde o id do evento, o mercado, a linha e o lado. São os mesmos quatro campos que você já recebe de /v3/odds, então não há nada para mapear.
- 2
Envie para liquidação
Depois da partida, faça um POST com até 50 seleções para /v3/settlements/grade. Cada uma volta como won, lost, void, half_won ou half_lost. A maioria dos mercados de placar também retorna o placar em que o resultado se baseou.
- 3
Liquide quando o resultado for definitivo
Toda resposta traz uma flag final. Guarde as seleções com final igual a false e envie de novo mais tarde. Uma vez por minuto é o máximo de que você precisa.
Sete respostas possíveis
Só liquidamos uma aposta quando o resultado armazenado comprova a resposta. Se faltar algo ou os dados não baterem, você recebe ungradeable com um motivo, nunca um palpite.
- won
- A aposta ganhou
- lost
- A aposta perdeu
- half_won
- Linha de quarto: metade do valor ganha e a outra metade é devolvida
- half_lost
- Linha de quarto: metade do valor perde e a outra metade é devolvida
- void
- Valor devolvido. O motivo é push ou event_cancelled
- pending
- Ainda não decidida. O motivo diz o que estamos esperando
- ungradeable
- Não conseguimos comprovar a resposta. O motivo explica por quê
Regras de liquidação que você pode ler
As regras seguem a prática comum das casas de apostas. Cada casa difere nos detalhes, então confira com os seus próprios termos.
Futebol liquida nos 90 minutos
Mercados de futebol, futsal, handebol e rúgbi são liquidados pelo tempo regulamentar. Prorrogação e disputa de pênaltis nunca contam, mesmo quando o placar da partida as inclui.
Prorrogação onde as casas a contam
No basquete, futebol americano, beisebol e hóquei no gelo, moneyline, spread e totais incluem a prorrogação e as entradas extras. 3-Way Result, Double Chance, Draw No Bet e os totais e spreads Regulation são liquidados pelo tempo regulamentar.
Linhas de quarto dividem o valor
Um handicap asiático de -0.75 é metade em -0.5 e metade em -1. Quando o mandante vence por um, a resposta é half_won. Uma linha inteira que cai exata é void com motivo push.
Partidas canceladas são anuladas
Toda aposta em um evento cancelado volta como void com motivo event_cancelled. Se a partida for remarcada, o evento volta para pending com o mesmo id.
Escanteios e cartões pelas estatísticas
Escanteios, cartões e primeiro time a marcar no futebol são liquidados pelas estatísticas pós-jogo, cerca de 30 minutos após o apito final. Até lá a resposta é pending com motivo awaiting_stats.
Props de jogadores pelo box score
Props são liquidadas no basquete, beisebol, hóquei no gelo e futebol americano. Identificamos o jogador pelo nome e recusamos quando o nome pode ser de duas pessoas.
172 mercados em 21 esportes
Os nomes dos mercados são os que /v3/odds entrega. O guia de liquidação lista todos os mercados por esporte.
Linhas principais
ML, 3-Way Result, Spread e handicaps asiáticos, Totals, Team Totals, European Handicap, Double Chance, Draw No Bet, Both Teams To Score, Odd/Even
Tempos, quartos e entradas
Versões de primeiro e segundo tempo das linhas principais, Half Time / Full Time, cada quarto no basquete e no futebol americano, cada período no hóquei no gelo, e mercados First 5 Innings e 1st Inning no beisebol
Tênis e esports
Handicap de games, total de games e games por jogador, apostas em sets, handicaps de sets, vencedores de set, totais de set e placar exato de sets no tênis, vôlei e tênis de mesa. Map Handicap, Total Maps, vencedores de mapa e linhas de rounds e kills por mapa nos esports, e linhas de frames na sinuca
Estatísticas de futebol
Escanteios, cartões, total de cartões, chutes no gol, finalizações, defesas do goleiro, impedimentos, faltas e desarmes, corrida de escanteios, primeiro e último escanteio, primeiro, último e do 2º ao 5º time a marcar, placar exato, margem de vitória, gols exatos e gols por time, vencer sem sofrer gols, time não sofre gols
Props de jogadores
Linhas de over e under do box score oficial no basquete, beisebol, hóquei no gelo e futebol americano
Ainda não liquidados
Mercados de artilheiro, props de jogadores de futebol, linhas de dardos, críquete e outrights. Eles voltam como unsupported_market
Com que frequência uma aposta é liquidada
Passamos por esta API 22,903 apostas que o nosso próprio bet tracker liquidou nos 30 dias até 12 de outubro de 2026. Esta é a parcela que voltou com um veredito.
- Beisebol, mercados de placar
- 99.6%
- Hóquei no gelo, mercados de placar
- 99.2%
- Basquete, mercados de placar
- 99.1%
- Futebol americano, mercados de placar
- 98.5%
- Futebol, mercados de placar
- 98.0%
- Cartões no futebol
- 88.3%
- Escanteios no futebol
- 82.4%
Use esses números como referência. Eles vêm de um mês de apostas de um único produto, principalmente mercados principais de futebol, em eventos que já tinham sido liquidados uma vez. O restante voltou como ungradeable com um motivo.
Perguntas frequentes sobre a API de liquidação de apostas
Como liquidar apostas automaticamente com uma API?
Guarde o id do evento, o mercado, a linha e o lado quando a aposta é feita. Depois da partida, envie-os para POST /v3/settlements/grade na API v3 da Odds-API.io. A resposta informa won, lost, void, half_won ou half_lost para cada aposta, e a flag final diz quando o resultado está confirmado.
O que é uma API de liquidação de apostas?
Uma API de liquidação de apostas recebe uma aposta que você tem e diz como ela terminou. Você envia o evento, o mercado, a linha e o lado, e ela retorna o resultado com base no placar final. Bet trackers, plataformas de tipsters, jogos de palpites e back offices de casas de apostas usam uma para não ter que escrever regras de liquidação para cada mercado e esporte.
Quais mercados e esportes a API consegue liquidar?
172 mercados em 21 esportes: moneyline, spreads e handicaps asiáticos, totais, ambas marcam, dupla chance, empate anula, mercados de primeiro tempo, games e sets no tênis, mapas nos esports, escanteios, cartões e ordem dos gols no futebol, e props de jogadores no basquete, beisebol, hóquei no gelo e futebol americano.
Ela liquida apostas de handicap asiático com linhas de quarto?
Sim. Envie como Spread com a linha em hdp. O handicap é sempre indicado para o mandante. Linhas de quarto como -0.75 retornam half_won ou half_lost quando metade do valor é devolvida, e uma linha inteira que cai exata retorna void com motivo push.
Uma aposta de futebol é liquidada nos 90 minutos ou após a prorrogação?
Nos 90 minutos mais os acréscimos. Apostas de futebol, futsal, handebol e rúgbi são liquidadas pelo tempo regulamentar, mesmo quando a partida vai para a prorrogação ou para os pênaltis. Na maioria dos mercados de placar, o resultado inclui o placar em que se baseou, para você mostrá-lo aos seus usuários. Half Time / Full Time, escanteios, cartões e props de jogadores retornam apenas o veredito.
O que acontece quando uma partida é adiada ou cancelada?
Na maioria dos casos o status do evento passa para cancelled e toda aposta nele é liquidada como void com motivo event_cancelled. Se a partida for remarcada, o evento volta para pending com o mesmo id. Uma partida que nunca tem resultado passa para ungradeable com motivo result_unavailable 72 horas após o início.
Quanto tempo depois de uma partida posso liquidar uma aposta?
Os mercados de placar costumam ficar prontos poucos minutos após o apito final. Escanteios, cartões e props de jogadores levam cerca de 30 minutos. Até lá a resposta é pending. A flag final passa para true quando o resultado é conferido com o oficial, ou 48 horas após o fim da partida.
Quais planos incluem a API de liquidação?
Os dois endpoints de liquidação estão em todos os planos pagos e cada chamada conta como uma requisição. GET /v3/settlements aceita até 50 ids de evento e POST /v3/settlements/grade aceita até 50 seleções.
Pare de escrever regras de liquidação
A liquidação vem com a mesma chave das odds de 450+ casas de apostas. Escolha um plano pago e envie suas primeiras seleções hoje mesmo.