El problema
Los traders de exchange suelen trabajar con hojas de cálculo y por intuición. No tienen un lugar seguro donde probar una estrategia antes de arriesgar dinero real, ni un registro único de apuestas, límites y resultados. Además había un límite insalvable: durante las pruebas, Betfair Italia rechazaba las órdenes de apuesta enviadas a través de su API desde servidores de centros de datos.
Lo que construí
Construí BetPilot AI, una plataforma web instalable de análisis, control de riesgo y simulación, en la que cada estrategia empieza en paper trading.
- Constructor visual de estrategias — las estrategias se guardan como un esquema declarativo, validado contra una lista blanca estricta. Nunca se ejecuta código del usuario.
- Asistente de estrategias con IA — el usuario describe una estrategia con sus propias palabras y Claude (Anthropic) la convierte en un esquema o mejora uno existente. Si la respuesta no supera la validación, el error vuelve al modelo para un nuevo intento.
- Motor de simulación — los backtests, las repeticiones y las comparaciones se ejecutan como tareas en segundo plano. El motor de casación modela liquidez, casaciones parciales, slippage y latencia, y es determinista: las mismas entradas dan el mismo resultado.
- Motor de riesgo y señales — límites de presupuesto (rango de importe, pérdida máxima diaria y semanal, rango de cuotas) y un asesor de importe: un cuarto de Kelly con un tope del 5% del bankroll cuando se indica una probabilidad y, si no, la regla del 2%. Cada señal muestra la cuota justa y el valor esperado.
- Diario real — el usuario registra cada apuesta real con un clic; bankroll, P&L, ROI y porcentaje de aciertos se mantienen al día.
- Datos en directo — estadísticas de partidos de API-Football y precios del exchange desde un agente de solo lectura en el ordenador del usuario.
- Seguridad y trazabilidad — inicio de sesión en dos pasos, secretos cifrados, aislamiento de datos por usuario, registro de auditoría, informes en PDF, CSV y XLSX, y notificaciones por email, push y webhook.
Las cifras
- Un conjunto de pruebas automatizadas, incluida una prueba que demuestra que el motor de simulación no puede enviar órdenes reales.
- 18 módulos de backend y 42 modelos de datos en el esquema de la base de datos.
- 7 deportes y 6 métodos de cálculo del importe admitidos por el formato de estrategia.
Con qué está hecho
Frontend en Next.js, React y TypeScript con Tailwind CSS y Recharts, exportado como archivos estáticos. Backend en NestJS con Clean Architecture, módulos orientados al dominio y CQRS, sobre PostgreSQL mediante Prisma. Redis y BullMQ gestionan la cola de tareas, con PostgreSQL como alternativa de respaldo. Integraciones: la API de Anthropic, API-Football y la API de Betfair en modo solo lectura.
Por qué se hizo así
Cuando el exchange bloqueó las apuestas desde el servidor, cambié el modelo. BetPilot analiza, calcula el importe y lleva las cuentas; la apuesta la coloca la persona. Para los datos de mercado escribí un agente local que solo llama a los métodos de lectura de Betfair y mantiene las credenciales en el PC del usuario. Los métodos de apuesta están bloqueados por diseño, así que el software sigue siendo una herramienta de apoyo a la decisión.
