La Instancia del Bot de MagicTradeBot es un ejecutable multiplataforma que admite Windows, Linux y macOS. Está diseñado para ejecutarse de forma independiente o junto con múltiples instancias, con configuración gestionada a través de un archivo central .yaml
.
Cada instancia del bot se conecta a la API de la Aplicación de Gestión de MagicTradeBot para autenticación, ejecución de operaciones y escaneo del mercado en tiempo real. Este documento explica los parámetros de configuración y las mejores prácticas para una comunicación segura.
📄 Estructura de Configuración YAML
La configuración principal de cada instancia del bot se almacena en un archivo config.yaml
. A continuación, se muestra un diseño de referencia:
server:
# Nombre
botName: "Bybit_Mainnet_Trading_Bot" # Nombre único para la instancia del bot
# CLAVE DE LICENCIA
licenseKey: "hRnWOLo91ESUiZ8SkN986w" # Requerida para activar y validar la instancia
# MODO DEMO
isDemo: true # true = modo simulación; false = comercio real
# CONFIGURACIÓN DE API
api: "https://localhost:7225/" # URL de la API de gestión de MagicTradeBot
# CONTROL DE EJECUCIÓN
refreshRate: 5 # Intervalo de escaneo del mercado en segundos
totalConcurrentTrades: 0 # Máx. de operaciones simultáneas (0 = ilimitado)
# GESTIÓN DE RIESGOS (0 = deshabilitado)
maxLoss: 0 # El bot se detiene si las pérdidas alcanzan este umbral
maxProfit: 0 # El bot se detiene si las ganancias alcanzan este umbral
# CONFIGURACIÓN DE CUENTA
exchangeId: 0 # ID de la cuenta a utilizar (desde la app de gestión)
# CONFIGURACIÓN DE PLANTILLA
templateId: 0 # ID de la plantilla de estrategia (0 = predeterminada)
# ESTRATEGIA DE COMERCIO
strategy: 0 # ID de la estrategia (ver lista abajo)
strategyMaxCount: 55 # Máx. pasos de progresión (0 = ilimitado)
# REFERENCIA DE ESTRATEGIAS:
# 0: Sin estrategia
# 1: Martingala 2: Martingala Inversa
# 3: Fibonacci 4: Fibonacci Inverso
# 5: 3-2-6-3 6: 3-2-6-3 Inverso
# 7: D'Alembert 8: D'Alembert Inverso
timeZone: "UTC" # Zona horaria para programación y operaciones
# CONFIGURACIÓN DEL SISTEMA
debug: true # Activar registros detallados
🔐 Recomendaciones de Comunicación Segura
Dado que las instancias del bot interactúan con la API de Gestión para obtener símbolos, escanear mercados y ejecutar operaciones, es esencial asegurar esta comunicación. A continuación, se indican prácticas clave:
1. Usar HTTPS para Endpoints de API
- Asegúrese de que el campo
api
utilice una URL HTTPS - Utilice certificados TLS válidos (por ejemplo, Let's Encrypt) para cifrar el tráfico
- Rechace todas las conexiones HTTP inseguras a la app de gestión
2. Aplicar Autenticación JWT
- Durante el arranque, el bot solicita un token JWT con sus credenciales
- Si son válidas, la app de gestión devuelve un token que se incluye en el encabezado
Authorization
de cada solicitud - Los tokens deben tener una corta duración y almacenarse de forma segura en memoria
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
3. Restringir Acceso con Lista Blanca de IPs
- Limite el acceso a la API de gestión solo a las IP conocidas donde corren los bots
- Implemente reglas de firewall para bloquear accesos externos no autorizados
4. Proteger Claves API y de Licencia
- No incruste secretos en el código ni los exponga en registros
- Cargue secretos desde variables de entorno o gestores cifrados
- Rote periódicamente las claves de licencia y credenciales de intercambio
5. Aislar Cada Instancia del Bot
- Asigne un
botName
único y despliegue en contenedores o entornos aislados - Limite los permisos si usa controles de acceso a nivel de sistema operativo
6. Monitorear y Auditar el Uso de la API
- Active registros de auditoría en la aplicación de gestión
- Registre todos los intentos de autenticación JWT y patrones de acceso inválidos
- Configure alertas con Sentry, Pushover o LogDNA para detectar anomalías
✅ Recomendaciones
- 📌 Use contraseñas seguras y comunicación cifrada entre todos los servicios
- 📌 Aísle la infraestructura del bot del acceso público
- 📌 Aplique actualizaciones regulares al sistema y a las apps de gestión y bot
- 📌 Programe copias de seguridad automáticas de configuraciones y registros