API de apuestas deportivas para integrar un sportsbook
Una API pensada para desarrolladores de operadores: un snapshot, deltas versionados y llamadas idempotentes para apostar.
Actualizado el 4 de octubre de 2026
La API de apuestas deportivas de Nocturn Sport permite a un casino o a un operador ofrecer nuestras cuotas propias dentro de su plataforma, con su diseño y su gestión de jugadores. Está organizada en cuatro bloques: flujo de cuotas, colocación de apuestas, historial y saldo.
1. Flujo de cuotas: snapshot y deltas versionados
La primera llamada devuelve un snapshot completo del catálogo prepartido: deportes, torneos, eventos, mercados y resultados con sus cuotas, junto con un número de versión. A partir de ahí, tu sistema consulta periódicamente indicando la última versión que tiene, aproximadamente cada 10 segundos, y recibe solo los cambios (deltas): cuotas nuevas, mercados suspendidos, eventos cerrados. Así se ahorra ancho de banda y se evita reconstruir el catálogo entero en cada consulta. El detalle de la estructura está en feed de cuotas.
2. Colocación de apuestas
Se aceptan simples y combinadas, con una sola selección por evento en cada combinada. Cada petición lleva un ID de solicitud propio del operador: si una llamada se repite por un corte de red, no se duplica el boleto. La respuesta confirma la aceptación o explica el rechazo (cuota cambiada, mercado cerrado, límite superado).
3. Historial de apuestas
Consulta los boletos de un jugador con su estado: pendiente, ganado, perdido o anulado, y el detalle de cada selección. Útil para el área de cliente del operador y para su atención al jugador.
4. Saldo del jugador
La API gestiona el saldo asociado a las apuestas, de modo que el boleto aceptado y el cargo correspondiente son coherentes.
Controles desde el back office
Lo que haces en el panel de riesgo se refleja en la API: suspender un evento, sobrescribir una cuota, liquidar un resultado, revisar la exposición y fijar cuota mínima y máxima, apuesta máxima, ganancia máxima, número máximo de selecciones, tiempo de cierre previo al inicio y margen.
Buenas prácticas de integración
- Guarda siempre la última versión recibida: si tu servicio se reinicia, retoma desde ella o pide un snapshot nuevo.
- Genera el ID de solicitud en tu lado antes de llamar y regístralo junto al boleto del jugador.
- Trata los rechazos por cambio de cuota como algo normal: muestra al jugador el precio nuevo y pídele confirmación.
- Respeta la hora de cierre: un evento que empieza en pocos minutos puede dejar de aceptar boletos antes de que tu interfaz se refresque.
Ejemplo de flujo completo
Un jugador abre tu sección de fútbol: tu servidor ya tiene el catálogo en memoria gracias al snapshot y a los deltas. Elige dos partidos para una combinada; tu sistema envía la apuesta con su ID, recibe la confirmación y descuenta el importe. Al terminar los partidos, el resultado se liquida y el historial del jugador muestra el boleto como ganado o perdido.
Cómo empezar
La API se ofrece directamente o mediante SoftAggregator, que combina en una sola integración juegos de casino y sportsbook. Las condiciones son a consultar. Pide la documentación técnica en [email protected], en Telegram @mentionso o desde contacto. Si buscas una interfaz ya hecha, mira el sportsbook en marca blanca; para la visión global, el software sportsbook.
Preguntas frecuentes
¿Cada cuánto debo consultar el flujo de cuotas?
El diseño recomendado es una consulta aproximadamente cada 10 segundos, indicando la última versión recibida; solo te llegan los cambios.
¿Qué pasa si repito una petición de apuesta?
Si reenvías la llamada con el mismo ID de solicitud, el servidor la identifica como repetida y devuelve el boleto original sin duplicarlo.
¿La API incluye cuotas en vivo?
No por ahora. El catálogo cubre solo eventos que aún no han empezado; el directo está en desarrollo.
¿Cuánto cuesta el acceso a la API?
Las condiciones se dan a consulta según el proyecto. Escribe a [email protected].