NOCTURN SPORT

API de sportsbook para operadores com front end próprio

Uma API pensada para integrar odds pré-jogo e ao vivo e o motor de apostas da Nocturn Sport em qualquer plataforma existente.

Atualizado a 27 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:

  1. Na primeira ligação, o cliente pede um snapshot completo: desportos, torneios, eventos, mercados e resultados com as respetivas odds.
  2. Cada snapshot e cada alteração têm um número de versão.
  3. 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.

Moedas e criptomoedas

Cada jogador tem uma única moeda, usada no saldo, no valor apostado e no pagamento dos ganhos. O sportsbook suporta 73 moedas: 60 fiduciárias e 13 unidades cripto, ou seja, as stablecoins USDT e USDC, o BTC (com as variantes mBTC e SATS) e ainda ETH, LTC, TRX, DOGE, SOL, XRP, BNB e TON. As taxas de câmbio são atualizadas de hora a hora e os limites de aposta definidos em euros são convertidos para cada moeda; assim, um jogador em USDT e outro em liras turcas ficam sujeitos aos mesmos tetos. A lista atualizada está disponível publicamente em nocturnsport.com/api/currencies.

Controlos de back office

ControloUso
Suspender eventoRetirar um jogo do mercado de imediato
Alterar preçoSubstituir manualmente qualquer odd
Liquidar resultadosFechar mercados com o resultado final
ExposiçãoVer a responsabilidade por evento e por mercado
LimitesOdd 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.

Novidades na Nocturn Sport

  • Apostas ao vivo em futebol, basquetebol, ténis e críquete
  • Cash-out antes do apito
  • Mercados de jogadores
  • Cantos, cartões e estatísticas do jogo
  • Futebol com menu completo
  • Odds aumentadas
  • Mais profundidade noutros desportos
  • Alertas de integridade
  • Definições por operador

Ver todos os mercados e opções →

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.

Os jogadores podem apostar em cripto?

Podem. Stablecoins, Bitcoin, Ether, Tron, Toncoin e outras moedas digitais de referência estão ao lado das moedas tradicionais, sem alterações na integração: basta indicar o código da moeda do jogador e a API trata do resto.

A API inclui odds ao vivo?

Inclui. O direto do futebol, basquetebol, ténis e críquete chega pelo mesmo feed, com marcador, relógio e suspensões. Os mercados detalhados, como jogadores, cantos e cartões, são servidos por jogo a pedido, e cada operador define o seu próprio atraso para apostas em direto.

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.

Também neste site