¿Qué es NeuroTrade AI?
Sistema de trading algorítmico multi-plataforma con IA. Combina un motor de scoring con 100+ indicadores, gestión de riesgo en 6 capas y un pipeline ML adaptativo para operar automáticamente en MT5 (Forex/CFDs) y BingX Futures (crypto).
🤖 Bot MT5
Opera en Forex y CFDs mediante un Expert Advisor en MetaTrader 5. Analiza señales cada 5 segundos.
📊 Bot BingX
Trading de futuros perpetuos en BingX. BTC/USDT principal + hasta 3 símbolos extra (ETH, SOL, etc.).
🧠 ML Adaptativo
Pipeline LightGBM que aprende de tus propios trades. Pasa de EXPLORATION → SHADOW → ACTIVE automáticamente.
📈 Panel Inversiones
Análisis de mercados, valoración fundamental, optimización de cartera (Efficient Frontier) e IA Advisor (Llama 3.3 70B).
Requisitos previos
Sistema operativo
El cliente Python funciona en Windows y Linux. El servidor requiere Linux (Ubuntu 20.04+).
Software necesario
| Componente | Versión mínima | Uso |
|---|---|---|
| Python | 3.10+ | Bots + servidor |
| MetaTrader 5 | Build 3000+ | Bot MT5 únicamente |
| PostgreSQL | 13+ | Base de datos central |
| Cuenta BingX | KYC completado | Bot BingX |
| Telegram Bot | Cualquiera | Alertas (opcional) |
Dependencias Python principales
# Instalar con pip
pip install flask sqlalchemy alembic psycopg2-binary
pip install lightgbm scikit-learn pandas numpy
pip install requests pyportfolioopt yfinance
pip install python-telegram-bot keyringInstalación rápida
-
Clona el repositorio y crea el entorno virtual
git clone https://github.com/tu-usuario/neurotrade.git cd neurotrade python -m venv venv && source venv/bin/activate # Linux # Windows: venv\Scripts\activate pip install -r server/requirements.txt pip install -r neurotrade/requirements.txt -
Configura PostgreSQL
createdb neurotrade # Ejecutar migraciones cd server && alembic upgrade head -
Inicia el servidor Flask
cd server NT_DATABASE_URL="postgresql://user:pass@localhost/neurotrade" \ python api/api_server.py -
Lanza el cliente NeuroTrade
cd neurotrade python launcher.py -
Regístrate e inicia sesión
Al abrir el launcher por primera vez, crea una cuenta en la pantalla de login.
Bot MT5 — Descripción general
El bot MT5 opera en Forex y CFDs mediante un ciclo de análisis de 5 segundos. Se comunica con el EA (Expert Advisor) instalado en MetaTrader 5 a través de archivos JSON en disco.
market_data.json → Python evalúa (scoring + ML) → si aprobado, el EA ejecuta la orden → el EA confirma apertura en open_fb_<id>.json → cierre en trade_feedback/<id>.json.
Estrategias disponibles
- TREND_FOLLOWING — Opera en la dirección de la tendencia principal (EMA 20/50/200, ADX≥20)
- TREND_PULLBACK — Entradas en retrocesos dentro de tendencias fuertes (RSI oversold/overbought)
- MEAN_REVERSION — Reversiones en mercados laterales (Bollinger Bands, RSI extremos)
Bot MT5 — Configuración
La configuración del bot MT5 se gestiona desde app.neurotrade.es → Settings → MT5 y se almacena en PostgreSQL.
| Parámetro | Descripción | Valor por defecto |
|---|---|---|
min_confidence | Score mínimo para abrir un trade (0–100) | 60 |
risk_percent | % del capital arriesgado por operación | 1.0 |
max_positions | Máximo de trades abiertos simultáneos | 3 |
sl_pips | Stop Loss en pips (EURUSD) | 15 |
tp_pips | Take Profit en pips (EURUSD) | 30 |
timeframe | Temporalidad del EA (M15, H1, H4) | H1 |
Expert Advisor (EA)
El EA EA_SignalExecutor.mq5 se instala en MetaTrader 5 y actúa como puente entre la plataforma y el bot Python.
Instalación del EA
- Copia
EA_SignalExecutor.mq5aMT5/MQL5/Experts/ - Compila en el editor MQL5 (F5)
- Arrastra a cualquier gráfico EURUSD M15 o H1
- Permite "Live Trading" y "DLL imports" en la configuración del EA
- Configura
DataPathcon la ruta de los archivos JSON del bot
C:/Users/<user>/AppData/Roaming/MetaQuotes/Terminal/Common/Files/
Motor de scoring MT5
El scoring asigna una puntuación de 0 a 100 a cada señal. Solo se ejecutan trades con score ≥ min_confidence.
| Componente | Puntos máx. | Descripción |
|---|---|---|
| Dirección HTF | 20 | Alineación con tendencia del TF superior |
| ADX / DI± | 15 | Fuerza de la tendencia (ADX≥20 óptimo) |
| EMA Alignment | 15 | EMAs 20/50/200 alineadas en cascada |
| RSI | 12 | No en zona de sobrecompra/venta extrema |
| MACD | 10 | Histograma y cruce en dirección correcta |
| Bollinger Bands | 8 | Precio cerca de la banda correcta |
| Sesión de mercado | 8 | OVERLAP/LONDON/NY score +8, ASIA −4 |
| Patrón de velas | 7 | ENGULFING, HAMMER, DOJI en nivel clave |
| SuperTrend | 5 | SuperTrend alineado con dirección |
Bot BingX — Descripción general
Opera en futuros perpetuos de BingX. El ciclo de evaluación es de ~60 segundos. Analiza BTC/USDT como par principal y opcionalmente hasta 2 pares adicionales (3-D multi-símbolo).
Bot BingX — Configuración
Configurable desde app.neurotrade.es → Settings → BingX o directamente en la GUI del bot.
| Parámetro | Descripción | Por defecto |
|---|---|---|
min_confidence | Score mínimo para operar (0–100) | 60 |
atr_sl_mult | Multiplicador ATR para Stop Loss | 1.5 |
atr_tp_mult | Multiplicador ATR para Take Profit | 3.0 |
leverage | Apalancamiento en BingX Futures | 5x |
risk_per_trade_pct | % del capital arriesgado por trade | 1.0 |
max_losses | Pérdidas consecutivas antes de pausa | 3 |
max_loss_pause_hours | Horas de pausa tras alcanzar max_losses | 2 |
extra_symbols | Pares adicionales (ej: ETH-USDT, SOL-USDT) | [] |
Estrategias BingX
El bot BingX usa el scorer "advanced" que combina todos los indicadores disponibles:
- EMAs 5/9/13/21/50/200 en cascada (TF operativo + superior)
- VWAP calculado (precio respecto al VWAP diario)
- SuperTrend (alineación con dirección)
- RSI + divergencias (BULLISH/BEARISH)
- MACD histograma y cruce
- ATR% para filtrar volatilidad extrema (<0.3% o >3% → penalización)
- Volume ratio (volumen actual vs media 20 períodos)
- Sesión de mercado (OVERLAP→×0.95, ASIA→×1.10, OFF→×1.40)
Parámetros de riesgo BingX
El sistema de riesgo se configura en la pestaña Configuración de la GUI del bot:
| Parámetro | Descripción |
|---|---|
direction_pause_losses | Pérdidas consecutivas en la misma dirección para pausarla |
direction_pause_minutes | Minutos de pausa de dirección |
same_symbol_mode | BLOCK / PYRAMID / REVERSE para posiciones múltiples |
max_pyramid_adds | Máximo de posiciones adicionales en modo PYRAMID |
Gestión de Riesgo — Las 6 capas
Cada señal pasa por 6 filtros de riesgo antes de ejecutarse. Si cualquiera falla, la señal es rechazada:
- RISK-01 — Umbral dinámico
Multiplica el score mínimo por un factor según régimen de mercado (CHOPPY×1.30, TREND_EXPANSION×1.0) y sesión (OFF×1.40, OVERLAP×0.95). - RISK-02 — CooldownManager
Cooldown post-pérdida: <1% → 5min, 1-2% → 15min, >2% → 60min, 2 pérdidas consecutivas → 3h. - RISK-03 — R/R mínimo dinámico
Ratio Risk/Reward mínimo según régimen: CHOPPY→2.5, TRENDING+HTF→2.0, RANGING→1.5. - RISK-04 — Control de posiciones múltiples
Modo BLOCK (por defecto) bloquea abrir el mismo símbolo dos veces. PYRAMID requiere score adicional. - RISK-05 — Circuit Breaker (4 niveles)
Ver sección Circuit Breaker. - RISK-06 — Detección de señal stale
Si el precio se movió más de 1×ATR en la dirección de la señal antes de ejecutarla, la señal se descarta.
Circuit Breaker
| Nivel | Trigger | Consecuencia | Reset |
|---|---|---|---|
| L1 | Drawdown diario >3% | Tamaño de posición ×0.5 para el resto del día | Medianoche UTC |
| L2 | Drawdown diario >5% | Bloqueo completo hasta medianoche UTC | Medianoche UTC |
| L3 | Drawdown semanal >8% | Bloqueo hasta el próximo lunes UTC | Lunes 00:00 UTC |
| L4 | 3 pérdidas consecutivas | Pausa automática de 2 horas | Automático tras 2h |
CooldownManager
Gestiona cooldowns per-símbolo tras cada pérdida. Cooldowns acumulativos:
- Pérdida <1% → 5 minutos de cooldown
- Pérdida 1–2% → 15 minutos
- Pérdida >2% → 60 minutos
- 2 pérdidas consecutivas en el mismo símbolo → 3 horas
Un trade ganador resetea el contador de consecutivos para ese símbolo.
R/R Dinámico
El ratio Risk/Reward mínimo exigido varía según el régimen de mercado detectado y la alineación con el timeframe superior (HTF):
| Régimen | HTF alineado | HTF no alineado |
|---|---|---|
| TREND_EXPANSION | 2.0 | 1.5 |
| RANGING | 1.5 | 1.5 |
| CHOPPY | 2.5 | 2.5 |
| LOW_VOLATILITY | 1.5 | 1.5 |
| VOLATILITY_SPIKE | 2.0 | 2.5 |
| LIQUIDATION_CASCADE | 2.5 | 2.5 |
Pipeline ML — Descripción
El pipeline ML local usa LightGBM entrenado con tus propios trades. Captura 60+ indicadores técnicos en cada apertura (features) y aprende qué condiciones predicen trades ganadores.
Features utilizados
Los features incluyen: EMAs, RSI, MACD, ATR, Bollinger Bands, ADX/DI+/DI−, VWAP, SuperTrend, volume ratio, sesión de mercado, régimen de mercado, dirección HTF/LTF y score de apertura.
Modos del ML
| Modo | Descripción | Comportamiento |
|---|---|---|
| EXPLORATION | Recopilación de datos | Opera normalmente, guarda features. No filtra trades. |
| SHADOW | Validación paralela | El modelo predice en paralelo sin bloquear trades. Acumula métricas de accuracy. |
| ACTIVE | Filtro activo | Si el modelo predice LOSS con confianza ≥ 60%, el trade se bloquea. |
Shadow Mode
En modo SHADOW, el modelo genera predicciones en paralelo sin afectar la ejecución real. Puedes ver el rendimiento en el dashboard web → Analíticas.
La transición a ACTIVE requiere:
- ≥25 predicciones resueltas (con resultado real conocido)
- Accuracy en shadow ≥ 54% (mejor que azar)
- AUC en holdout de 2 semanas ≥ 0.55
Panel de Inversiones
Módulo de análisis de mercados con IA. No ejecuta órdenes — es informativo. Acceso desde el cliente desktop o desde app.neurotrade.es → Inversiones.
Tab Mercados
Datos en tiempo real de:
- Fear & Greed Index (crypto) con tendencia vs ayer
- Índices globales: S&P 500, NASDAQ, DAX, Nikkei, FTSE, Hang Seng
- Forex: 9 pares EUR/USD, GBP/USD, USD/JPY, etc.
- Macro EEUU: VIX, US10Y, DXY, Gold, Oil
- Sectores YTD: 8 ETFs sectoriales del S&P 500
Tab Fundamental
Busca cualquier ticker (AAPL, MSFT, AMZN...) para obtener:
- 12 métricas fundamentales con semáforo de color (verde/amarillo/rojo)
- Gráfico histórico de precio con SMA20/SMA50
- Valoración IA (Llama 3.3 70B) — consume 1 crédito de tu cuota diaria
Tab Carteras
Optimización de cartera mediante Efficient Frontier (PyPortfolioOpt):
- Introduce tus tickers separados por coma (ej:
AAPL,MSFT,GOOGL,AMZN) - Elige tu perfil de riesgo: Conservador / Moderado / Agresivo
- El sistema calcula pesos óptimos, Sharpe ratio, VaR y Max Drawdown
- Visualiza la Efficient Frontier como gráfico interactivo
IA Advisor
Chat con Llama 3.3 70B especializado en análisis financiero. El contexto incluye datos de mercado en tiempo real.
| Plan | Consultas/día |
|---|---|
| FREE | 0 (sin acceso) |
| STANDARD | 3 consultas |
| PREMIUM | 5 consultas |
El historial del chat se sincroniza entre el cliente desktop y la web automáticamente (PostgreSQL).
Dashboard Web — app.neurotrade.es
Accede al dashboard desde cualquier navegador en app.neurotrade.es. Las mismas credenciales que el cliente desktop.
Secciones disponibles:
- Dashboard — KPIs en tiempo real: balance, trades abiertos, P&L diario, equity curve
- Bot Status — Estado de MT5 y BingX con estadísticas por plataforma
- Trades — Historial completo con filtros y paginación
- Analíticas — Medidores de Win Rate, equity curve, rendimiento por régimen y mes
- Inversiones — Panel completo de inversiones
- Buzón — Mensajes del sistema y notificaciones
- Planes — Información sobre tu plan actual
- Settings — Configurar parámetros del bot desde el navegador
Configurar parámetros desde la web
Ve a Settings en el menú lateral. Los cambios se guardan en PostgreSQL y el bot los aplica en el siguiente ciclo.
Analíticas
La página de Analíticas muestra:
- Medidores de Win Rate (MT5 y BingX) en formato semicircular
- Equity curve con selector 30d / 90d / 1 año
- Rendimiento por régimen de mercado (barras)
- Distribución de scores por bucket
- P&L mensual (barras verdes/rojas)
- Win Rate por dirección (BUY vs SELL)
Planes y límites
| Feature | FREE | STANDARD | PREMIUM |
|---|---|---|---|
| Bots disponibles | 1 (7 días) | 1 permanente | MT5 + BingX |
| Motor de scoring | Básico | Completo | Completo |
| ML Adaptativo | — | ✓ | ✓ |
| Circuit Breaker | Básico | 4 niveles | 4 niveles |
| Panel Inversiones | — | ✓ | ✓ |
| IA Advisor | — | 3/día | 5/día |
| Multi-símbolo BingX | — | — | Hasta 3 pares |
| Correlación multi-bot | — | — | ✓ |
| Soporte | — | <48h email | <24h email |
| Precio | 0€ / 7d | 9,99€/mes | 14,99€/mes |
Solución de problemas
El bot MT5 no abre trades
- Verifica que el score mínimo (
min_confidence) no sea demasiado alto. Prueba bajarlo a 55-60 temporalmente. - Comprueba el Circuit Breaker: si el drawdown diario supera el 3-5%, el bot está en pausa hasta medianoche.
- El EA debe estar activo en MT5 con "Live Trading" habilitado.
- Revisa que
market_data.jsonse está actualizando (el EA lo escribe cada ~5s).
El bot BingX no opera
- El scoring de BTC puede estar bajo (mercado lateral o choppy). Consulta el Monitor IA en la GUI.
- Revisa si hay un CooldownManager activo en la pestaña Estadísticas.
- Verifica que las API keys tienen permisos de trading en Futures.
- Si
min_confidence=75, considera bajarlo a 60-65 en mercados laterales.
No recibo notificaciones de Telegram
- Ve a Settings en la GUI → pestaña General → verifica token y chat ID.
- Usa
/startcon tu bot de Telegram y obtén el chat ID con/getUpdates. - El bot de Telegram solo se conecta cuando el bot de trading está activo.
El dashboard web muestra "—" en todas las métricas
- Verifica que el servidor Flask está corriendo (
api.neurotrade.es). - Comprueba que la sesión web no ha expirado (cierra sesión y vuelve a entrar).
- El bot desktop debe haber enviado un heartbeat reciente (hace <2min) para mostrar estado "activo".
FAQ Técnica
¿El bot necesita estar siempre encendido?
Sí. El bot Python debe correr continuamente. Puedes dejarlo en un PC dedicado o en un VPS. Tiene watchdog automático que lo reinicia si crashea.
¿Qué pasa si el servidor cae?
Los trades se siguen ejecutando localmente. La cola de eventos SQLite guarda todos los registros y los sube al servidor cuando se reconecta. No se pierden datos.
¿Puedo cambiar el timeframe del bot?
Para MT5: cambia el gráfico del EA en MetaTrader 5 (M15, H1, H4). Para BingX: edita timeframe en la GUI → Configuración.
¿Cómo veo qué está haciendo el bot en tiempo real?
La GUI del bot tiene una pestaña Monitor IA (BingX) y Log en vivo (MT5) donde aparecen todas las evaluaciones de señal con desglose del scoring.
¿El sistema funciona con cualquier bróker MT5?
Sí, con cualquier bróker que soporte MetaTrader 5. No dependemos de ningún bróker específico. Probado con ICMarkets, Pepperstone, XM y FTMO.
¿Puedo usar el sistema sin el bot (solo el panel web)?
El dashboard web muestra datos históricos y permite configurar parámetros incluso sin el bot activo. El panel de Inversiones funciona de forma completamente independiente del bot.
¿Algo no funciona? Contáctanos en travicuba1997@gmail.com o abre un ticket en contacto.