Motor de detección de apuestas de valor que combina las predicciones del Sports Engine con cuotas reales (The Odds API en vivo; football-data.co.uk para histórico). Calcula Expected Value y dimensiona con Kelly Criterion. Su backtest es real y se publica sin maquillaje: sobre las temporadas 24/25 y 25/26 (758 partidos nunca vistos por el modelo, cuotas de cierre medias), la estrategia con stake plano pierde un 2.9% — aproximadamente el margen del bookmaker, porque el modelo empata con el mercado antes de comisiones. Y la gestión half-Kelly, que amplifica cuando el edge estimado no es real, convierte esa pérdida en −78% de bankroll. Es el resultado esperable según la literatura y la mejor lección del proyecto: el mecanismo (EV, Kelly, calibración) es ingeniería sólida; la promesa de beneficio contra el cierre del mercado, no.
Integración, datos y licencia
- Integración: API REST propia (FastAPI) con 7 endpoints documentados en el repositorio; se puede consumir desde cualquier lenguaje o plataforma, con especificación OpenAPI autogenerada.
- Tratamiento de datos: el procesamiento se realiza íntegramente en el servidor del proyecto, sin enviar datos a servicios de IA de terceros. No se almacenan las consultas de la demo.
- Licencia: MIT — uso libre, incluido comercial, manteniendo el aviso de copyright. El repositorio contiene la aplicación completa y puede desplegarse en infraestructura propia. El código es gratuito; los costes de motor de IA, infraestructura, implantación y mantenimiento corren por cuenta de quien lo despliega (no se ofrece soporte ni consultoría).
¿Cómo lo integro?
Disponible ahora: API REST con señales de valor, detalle por partido y backtest reproducible.
Integraciones habituales en este sector (valoradas como vía recomendada; salvo que se indique lo contrario, no vienen implementadas — el código está preparado para añadirlas):
- The Odds API: cuotas de múltiples casas en un solo formato; la fuente más práctica para detectar valor real.
- Betfair Exchange API: mercado de intercambio con precios de referencia y posibilidad de ejecución; requiere clave de aplicación.
- Hojas de cálculo / Notion — YA IMPLEMENTADO:
GET /ml/valuebet/signals.csv devuelve una fila por value bet con cuota, probabilidad del modelo, edge, EV% y Kelly, lista para Excel, Google Sheets o un tracker propio.