API de sportsbook para operadores com front end próprio
Uma API pensada para integrar odds pré-jogo e o motor de apostas da Nocturn Sport em qualquer plataforma existente.
Atualizado a 4 de outubro de 2026
A API de sportsbook da Nocturn Sport destina-se a operadores que já têm, ou querem construir, a sua própria interface de apostas. Fornece o catálogo de eventos e odds, recebe as apostas dos jogadores e devolve o seu estado, enquanto o back office permite gerir o risco. As odds são calculadas pelos nossos modelos, sem feed de preços de terceiros.
Feed de odds: snapshot e deltas versionados
A sincronização foi desenhada para ser simples e robusta:
- Na primeira ligação, o cliente pede um snapshot completo: desportos, torneios, eventos, mercados e resultados com as respetivas odds.
- Cada snapshot e cada alteração têm um número de versão.
- A seguir, o cliente consulta a API com a última versão que recebeu, por volta de cada 10 segundos, e obtém apenas os deltas: odds alteradas, mercados suspensos, eventos novos ou removidos.
Se o cliente perder a sequência, basta pedir um novo snapshot. Este modelo evita tráfego inútil e garante que o estado local se mantém igual ao nosso.
Colocação de apostas
A API aceita apostas simples e múltiplas. Cada pedido leva um ID de pedido gerado pelo cliente, o que torna a operação idempotente: se a ligação cair e o pedido for repetido, a aposta não é registada duas vezes. A resposta confirma ou recusa a aposta, por exemplo se a odd mudou, se o mercado fechou ou se um limite foi ultrapassado.
Boas práticas de integração
Algumas recomendações que poupam tempo às equipas técnicas. Guarde localmente a última versão aplicada e trate os deltas por ordem. Mostre ao jogador a odd que estava no ecrã no momento do clique e envie-a com o pedido, para que uma alteração de preço seja detetada e comunicada com clareza. Feche a interface de aposta ao mesmo tempo que o mercado, ou seja, no tempo de fecho definido antes do início (por defeito, um minuto). E registe os IDs de pedido do seu lado para conciliar apostas com a contabilidade da plataforma.
Histórico e saldo
Há endpoints para consultar o histórico de apostas de um jogador (abertas, ganhas, perdidas, anuladas) e o saldo do jogador, para que o front end mostre sempre informação atualizada.
Controlos de back office
| Controlo | Uso |
|---|---|
| Suspender evento | Retirar um jogo do mercado de imediato |
| Alterar preço | Substituir manualmente qualquer odd |
| Liquidar resultados | Fechar mercados com o resultado final |
| Exposição | Ver a responsabilidade por evento e por mercado |
| Limites | Odd mín./máx., aposta máxima, pagamento máximo, seleções por bilhete, fecho antes do início, margem |
Integrar pela SoftAggregator
A API também pode ser integrada através da SoftAggregator, que junta jogos de casino e o sportsbook Nocturn Sport numa só ligação. Para quem prefere não desenvolver interface, existe o sportsbook white label; para conhecer a estrutura do feed, veja a página do feed de odds.
Documentação técnica e preços (sob consulta): [email protected], Telegram @mentionso ou a nossa página de contacto.
Perguntas frequentes
Com que frequência devo consultar os deltas?
A recomendação é cerca de 10 segundos, enviando sempre a última versão recebida. Assim recebe apenas o que mudou desde então.
Como se evita registar a mesma aposta duas vezes?
Cada pedido de aposta leva um ID único gerado pelo seu sistema. Se o pedido for reenviado com o mesmo ID, a API reconhece-o e não cria uma segunda aposta.
A API suporta múltiplas?
Sim, apostas simples e múltiplas, com uma seleção por evento e um número máximo de seleções configurável pelo operador.
Como obtenho a documentação?
Peça-a por e-mail para [email protected] ou pelo Telegram @mentionso; enviamos a documentação e esclarecemos as dúvidas da sua equipa técnica.