Integração de API de apostas esportivas: odds, apostas e liquidação
Odds, aceitação de apostas e liquidação de cupons para a sua casa de apostas: uma única API JSON, documentação passo a passo e consultoria sobre a API com a nossa equipe.
As quatro partes da integração
Use só o que o seu produto precisa: apenas as odds ou o ciclo completo, da odd ao pagamento.
Odds e linha esportiva
Eventos prematch e live, mercados de apostas e odds atuais de mais de 25 esportes e esports. A partir de $30/mês.
API de odds esportivas →Aceitação de apostas
Apostas simples e múltiplas. A API confere de novo a odd e a disponibilidade do resultado no momento da aposta.
Coupon API →Liquidação
Os cupons são liquidados automaticamente; o resultado chega por callback assinado ou por consulta. A partir de $300/mês.
Documentação da liquidação →Interface pronta
Sem tempo para criar a interface de apostas? Incorpore o widget de apostas esportivas com eventos, odds e cupom.
Widget de apostas esportivas →Uma casa de apostas com o seu design e os nossos dados
Partidas ao vivo com odds em movimento, um cupom que confere o preço antes de aceitar a aposta e apostas liquidadas no histórico do jogador. O design é seu; os dados, a conferência das odds e a liquidação ficam com a SportAPI.
- Linha live e prematch
- Odds em tempo real
- Odd conferida na aposta
- Site e app mobile
~20min
até a primeira tela com eventos reais usando os nossos exemplos
1dia
para odds, apostas e liquidação com um agente de IA e a nossa documentação para IA
5–30dias
para uma equipe de desenvolvimento própria típica, conforme a experiência
2dias
de acesso grátis a todos os esportes, prematch e live, para testar a integração
Da odd no seu site ao pagamento
Seis chamadas cobrem todo o ciclo da aposta. O seu servidor fala com a SportAPI; os jogadores só veem a sua interface.
- 01↓ →
Menu de esportes
menu retorna esportes, países e campeonatos para prematch ou live.
- 02↓ →
Eventos e odds
events e event retornam partidas, mercados e odds atuais.
- 03↓ →
Ponteiro da aposta
O resultado escolhido é enviado como ponteiro com a odd que o jogador viu.
- 04↓ →
Criar o cupom
coupons/place confere a odd e aceita uma aposta simples ou múltipla.
- 05↓ →
Liquidação
Depois da partida o cupom é liquidado e você recebe um callback assinado.
- 06
Pagamento
O seu sistema credita o prêmio no saldo do jogador.
Os jogadores falam com você; você fala com a SportAPI
O seu site e o seu app chamam apenas o seu back-end. O back-end guarda a chave de API, faz cache da linha para todos os jogadores, envia as apostas para a SportAPI e recebe a liquidação por um callback assinado.
- A chave de API nunca vai para o navegador
- Um cache para todos os jogadores
- Seus saldos, suas regras
- Callback assinado com HMAC
Seis passos até o lançamento
Os passos 1–3 colocam uma linha esportiva ao vivo no seu site. Os passos 4–6 só são necessários se você aceita apostas pela SportAPI.
1. Chave de teste
Envie uma solicitação pelo Telegram. O teste dá 2 dias de acesso a todos os esportes, prematch e live.
2. Primeira requisição
Chame menu com a chave no header Package e monte a primeira tela de eventos.
3. Odds e live
Carregue eventos e odds, atualize os dados live nos intervalos recomendados e esconda os resultados bloqueados.
Abrir4. Aceitar apostas
Obtenha um JWT, monte o ponteiro da aposta a partir do resultado escolhido e crie o cupom.
Abrir5. Receber a liquidação
Verifique a assinatura HMAC do callback ou consulte os cupons liquidados; processe cada lote uma única vez.
Abrir6. Entrar em produção
Escolha um plano, troque para a chave de produção e mantenha a consulta à API como reserva para os callbacks.
Apostas liquidadas sem trabalho manual
Depois da partida, cada cupom recebe o resultado automaticamente: ganha, perdida, reembolso ou meio ganho nos mercados asiáticos. O callback traz o valor a pagar, as repetições nunca geram pagamento em dobro e a consulta à API recupera os resultados depois de uma queda.
- Simples e múltiplas
- Ganha, perdida, reembolso
- Repetições seguras com batchId
- Recuperação após queda
Entra a odd, sai a aposta: duas requisições
Para as odds, use a chave de API no header Package. Para a aposta, um JWT e o ponteiro do resultado escolhido. Exemplos completos em cURL, Python, PHP e JavaScript estão na documentação.
# 1. Menu de esportes ao vivo (Sport Line API)
curl 'https://YOUR_API_DOMAIN/v1/menu/live/br' \
--header 'Package: YOUR_API_KEY'
# 2. Aposta simples (Coupon API)
curl -X POST "$BASE_URL/api/partner/coupons/place" \
--header "Authorization: Bearer $CLIENT_TOKEN" \
--header "Content-Type: application/json" \
--data '{"list_bets": ["line#737779544#1#1#0#1.85"], "amount": 10}'A sua parte e a nossa parte
A sua parte
O seu servidor guarda a chave de API e faz todas as requisições. Você cuida das contas e saldos dos jogadores, da interface e dos pagamentos, e decide quais esportes e mercados exibir.
A nossa parte
As odds, a conferência da odd no momento da aposta, a liquidação e a entrega do resultado, a documentação com exemplos e a consultoria sobre a API. Não escrevemos o seu código, mas a nossa equipe pode fazer a integração por um valor adicional.
Quanto custa a integração
As odds são pagas mensalmente conforme o número de esportes. Comece com um teste grátis de 2 dias em todos os esportes. Aceitação e liquidação de apostas (Coupon API): a partir de $300/mês, com $20 por mês para apostas de teste. Pague vários meses adiantado e economize até 30%.
Um esporte para testar a integração em um produto real.
- Esportes: 1
- Prematch + Live
- Idiomas: EN
- Principais ligas
- Suporte: 8/5
Dez esportes para uma casa de apostas em crescimento.
- Esportes: 10
- Prematch + Live
- Idiomas: EN, RU
- Principais ligas
- Suporte: 12/7
Todos os esportes e esports para uma casa de apostas completa.
- Esportes: todos
- Prematch + Live
- Idiomas: EN, RU
- Principais ligas
- Esports incluídos
- Suporte: 24/7
Perguntas sobre a integração da API de apostas
Como funciona a integração de uma API de apostas esportivas
A integração de API de apostas esportivas traz para o seu produto três coisas que ele não gera sozinho: odds atuais, aceitação de apostas e liquidação depois da partida. Na SportAPI, cada parte é uma API JSON separada: você pode começar pelas odds e adicionar as apostas depois, sem refazer a interface.
Integração da API de apostas esportivas passo a passo
A primeira parte são as odds. O seu servidor solicita o menu de esportes, a lista de eventos e o evento completo com mercados e odds, guarda os identificadores e atualiza o live nos intervalos recomendados. Os resultados bloqueados são desativados na interface para que ninguém aposte em um preço fechado.
A segunda parte é a aceitação de apostas. Ao confirmar o cupom, o seu back-end envia o ponteiro de cada resultado escolhido com a odd que o jogador viu. A conferência das odds rejeita o cupom ou aceita o novo preço conforme o modo que você escolher.
A terceira parte é a liquidação. Depois do evento, o cupom é liquidado automaticamente e o resultado chega ao seu callback com assinatura HMAC. O seu sistema credita o prêmio no saldo do jogador e, por segurança, continua consultando os cupons liquidados.
API para casas de apostas: o que planejar
Comece pelo servidor. A chave de API e o JWT nunca chegam ao navegador: todas as requisições passam pelo seu back-end, que também faz cache da linha e evita os limites de requisições. Defina quais esportes e mercados vai exibir, como vai mostrar as mudanças de odds e o que fazer com um cupom rejeitado.
Depois, a conciliação. Uma integração confiável guarda o código de cada cupom, processa cada lote do callback uma única vez e recupera os resultados depois de uma queda. Essas três regras evitam os erros mais caros: pagamento em dobro e aposta perdida.
Integração por conta própria ou com a nossa equipe
A maioria das equipes integra a API por conta própria com a documentação, que traz exemplos de cada método e uma versão para agentes de IA. A consultoria sobre a API é gratuita. Se você não tem desenvolvedores, a equipe da SportAPI pode fazer a integração por um valor adicional, ou você pode lançar mais rápido com o widget de apostas esportivas ou uma plataforma de apostas pronta para uso.
Checklist antes do lançamento
Antes de ir para produção, confira quatro pontos. A linha do seu site bate com a resposta da API para o mesmo evento, incluindo os resultados bloqueados. Um cupom com odd alterada é rejeitado ou aceito conforme o modo escolhido, e o jogador vê o motivo. Um cupom liquidado credita o saldo uma única vez, mesmo que você repita o mesmo callback. Se você parar o seu endpoint de callback por uma hora, a consulta à API recupera todos os resultados. Se tudo passar com a chave de teste, a integração está pronta para jogadores reais.
Erros comuns de integração
Chamar a API pelo navegador e expor a chave. Atualizar o live mais vezes do que o recomendado e esbarrar nos limites. Tratar um HTTP 200 como sucesso sem verificar o código de negócio. Creditar o prêmio duas vezes quando o mesmo callback chega de novo. Tudo isso é explicado no guia de integração e no guia rápido de aceitação de apostas.