Guía de instalación

Prerrequisitos

• Docker Desktop (solo requerido si se usa Redis)
• Una cuenta de exchange compatible con claves API
• La dirección IP pública de tu servidor (para la lista blanca de API)

Tabla de Contenidos

1. Configuración del Bot
2. Configuración de Claves API
3. Configuración de Redis
4. RedisMarketBridge
5. Ejecución del Bot
6. Solución de Problemas
7. Integración con TradingView

1. Configuración del Bot

Toda la configuración se realiza mediante el configurador en línea.

1. Abrir: Configurador
2. Seleccionar MagicTradeBot
3. Configurar:

Exportar configuración:

1. Hacer clic en Exportar todo en YAML
2. Descomprimir
3. Reemplazar la carpeta /settings en el proyecto

magictradebot/
├── settings/  ← reemplazar
├── MagicTradeBot
├── MagicTradeBot.exe
└── .env

2. Configuración de Claves API

🔐 Seguridad: Usa siempre variables de entorno. Nunca guardes claves API en archivos de configuración.

Whitelist de IP

curl ifconfig.me

Añade esta IP a la lista blanca de tu exchange.

Uso de .env

BINANCE_API_KEY=tu_clave
BINANCE_API_SECRET=tu_secreto

⚠️ Añade .env a .gitignore

3. Configuración de Redis (Opcional)

Solo es necesario si Redis está habilitado.

Ejecutar Redis con Docker

docker run -d \
--name magictradebot-redis \
-p 6379:6379 \
--restart unless-stopped \
redis:latest

Verificar

docker exec -it magictradebot-redis redis-cli ping

Resultado esperado: PONG

4. RedisMarketBridge

Este componente envía datos de mercado en vivo a Redis.

⚠️ El exchange + pares + intervalos DEBEN coincidir exactamente con la configuración del bot

Pasos:

1. Configurar mediante el configurador
2. Exportar YAML
3. Reemplazar adapters/redismarketbridge/settings

5. Ejecución del Bot

Orden de inicio

1. Iniciar Redis
2. Iniciar RedisMarketBridge
3. Esperar 2 minutos
4. Iniciar MagicTradeBot

Linux / macOS

chmod +x MagicTradeBot
./MagicTradeBot

Windows

MagicTradeBot.exe

💡 Ejecuta desde la terminal para ver los logs

6. Solución de Problemas

Errores de API

• Revisar whitelist de IP
• Verificar permisos
• Comprobar variables de entorno

Sin datos de mercado

• Esperar 2 minutos tras iniciar RedisMarketBridge
• Verificar coincidencia de configuración

Problemas con Redis

• Comprobar que Docker está activo
• Puerto 6379 abierto

7. Integración de Señales TradingView

MagicTradeBot soporta señales externas de TradingView mediante webhooks.

Cómo funciona

• TradingView envía alertas → webhook
• MagicTradeBot recibe señales
• El bot ejecuta operaciones automáticamente

Paso 1 — Activar Webhook en el Bot

En la configuración del bot:

• Activar Señales → Webhook
• Copiar la URL del webhook

Ejemplo:

http://tu-servidor:puerto/webhook

Paso 2 — Crear alerta en TradingView

1. Abrir gráfico en TradingView
2. Añadir indicador o estrategia
3. Hacer clic en Alert
4. Activar Webhook URL
5. Pegar la URL del webhook del bot

Paso 3 — Definir mensaje de alerta

Ejemplo de payload JSON:

{
  "symbol": "BTCUSDT",
  "action": "buy",
  "price": "{{close}}",
  "time": "{{time}}"
}

Acciones soportadas

• buy
• sell
• close

Notas importantes

• Asegúrate de que el símbolo coincida exactamente con la configuración del bot
• Usa la misma temporalidad
• Prueba primero con operaciones pequeñas

⚠️ Formato incorrecto del payload = señales ignoradas

Prueba

Puedes simular un webhook con:

curl -X POST http://tu-servidor/webhook \
-H "Content-Type: application/json" \
-d '{"symbol":"BTCUSDT","action":"buy"}'

✅ Si está correctamente configurado, el bot ejecutará una operación

💡 Para más detalles, consulta la documentación oficial de integración de TradingView.