¿Qué es application.yaml en MagicTradeBot?

¿Qué es application.yaml?

application.yaml es el archivo de configuración principal que controla cómo MagicTradeBot se inicia, se conecta a los exchanges, se identifica y opera a nivel de sistema.

Piense en él como la configuración de arranque de MagicTradeBot — antes de que se ejecute cualquier estrategia, Market Watch o lógica del motor de decisión, el bot lee este archivo para comprender:

  • A qué exchange conectarse
  • Cómo autenticarse de forma segura
  • Si debe ejecutarse en modo demo o en vivo
  • Qué licencia usar
  • Comportamiento básico en tiempo de ejecución (depuración, nomenclatura, entorno)

Sin un application.yaml válido, MagicTradeBot no puede inicializarse ni operar correctamente.

¿Qué controla application.yaml?

El archivo application.yaml es responsable de la configuración global, no relacionada con la estrategia, incluyendo:

  • Selección del exchange y reglas de compatibilidad
  • Autenticación API (o mapeo de variables de entorno)
  • Validación de la licencia
  • Identidad del bot y banderas de tiempo de ejecución
  • Comportamiento de seguridad e implementación

NO define:

  • Estrategias de trading
  • Reglas de stop-loss / take-profit
  • Lógica de Market Watch
  • Reglas de decisión de DCA o Brain

Esas se manejan en archivos de configuración separados y específicos de funciones, manteniendo las responsabilidades limpias y modulares.

Explicación de las secciones clave

1. Configuración del exchange

Esta sección le dice a MagicTradeBot a qué exchange conectarse y cómo.

Responsabilidades clave:

  • Selecciona el exchange (binance, bybit, okx, bitget, hyperliquid)
  • Aplica la compatibilidad del modo de posición específico del exchange
  • Carga de forma segura las credenciales de la API

MagicTradeBot realiza una validación estricta aquí para evitar:

  • Modos de posición incorrectos (ej., Hedge vs One-Way)
  • Ejecución de órdenes fallida
  • Cálculos de PnL incorrectos
  • Desajustes en la gestión de riesgos

Si se configura un exchange no compatible, el bot se negará a operar.

2. Credenciales de API y seguridad

application.yaml admite dos métodos seguros para las credenciales:

Opción A: YAML directo (recomendado solo para demo/pruebas)

APIKEY: ""
APISECRET: ""
Passphrase: ""

Opción B: Variables de entorno (recomendado para producción)

Las variables de entorno anulan automáticamente los valores YAML.

Este diseño:

  • Evita la exposición accidental de claves
  • Funciona perfectamente con Docker, VPS e implementaciones en la nube
  • Se alinea con las mejores prácticas de seguridad empresarial

MagicTradeBot nunca requiere permisos de retiro y advierte explícitamente contra ellos.

3. Compatibilidad del modo de posición (Crítico)

Diferentes exchanges admiten diferentes modos de posición, y MagicTradeBot los aplica al inicio.

Ejemplos:

  • Bybit → Solo modo One-Way
  • Binance / OKX / Bitget → Modo Hedge requerido

Si su cuenta de exchange está mal configurada:

  • Las órdenes pueden ser rechazadas
  • TP/SL puede fallar
  • Las posiciones pueden cerrarse incorrectamente

Esta validación existe para proteger el capital y garantizar un comportamiento determinista.

4. Configuración de la licencia

La sección de Licencia activa su instalación de MagicTradeBot.

License:
  Key: ""

La licencia:

  • Desbloquea funciones según su plan
  • Controla la autorización de la instancia
  • Se valida durante el inicio

Sin una clave de licencia válida, el bot no entrará en modo operativo.

5. Configuración general de la aplicación

Esta sección controla cómo se comporta el bot en tiempo de ejecución — no cómo opera.

Opciones clave:

  • BotName – Ayuda a identificar esta instancia en registros, paneles y alertas
  • DemoMode – Habilita el trading simulado sin fondos reales
  • DebugMode – Habilita el registro detallado para diagnósticos

Estas configuraciones son especialmente útiles al ejecutar:

  • Múltiples instancias de bot
  • Entornos de prueba vs producción
  • Investigaciones de depuración o soporte

Modo demo vs modo en vivo

Una de las banderas más importantes en application.yaml es:

DemoMode: true
  • DemoMode = true → No se colocan órdenes reales
  • DemoMode = false → El trading en vivo está habilitado

Esto permite a los usuarios:

  • Probar configuraciones de forma segura
  • Validar estrategias antes de arriesgar capital
  • Ejecutar el bot en simulación con datos de mercado reales

Por qué MagicTradeBot usa application.yaml

MagicTradeBot usa application.yaml porque proporciona:

  • Estructura legible por humanos
  • Fuerte separación de preocupaciones
  • Valores predeterminados seguros para usuarios primerizos
  • Automatización fácil mediante variables de entorno
  • Compatibilidad con Docker, nube e implementaciones locales

Lo más importante es que garantiza un comportamiento de inicio predecible, esencial para un sistema de trading automatizado.

Mejores prácticas

  • ✔ Utilice variables de entorno para las claves de API en producción
  • ✔ Mantenga DemoMode habilitado durante las pruebas
  • ✔ Vuelva a verificar el modo de posición del exchange antes de pasar a vivo
  • ✔ Nunca habilite permisos de retiro en las claves de API
  • ✔ Trate application.yaml como configuración de infraestructura, no como configuración de estrategia

Resumen

application.yaml es la base del entorno de ejecución de MagicTradeBot.

Define:

  • Dónde se conecta el bot
  • Cómo se autentica
  • Si opera en vivo o en demo
  • Qué licencia está activa
  • Qué tan seguro se ejecuta

Toda la inteligencia avanzada — como Smart SL/TP, Market Watch, DCA y el cerebro de MagicTradeBot — se construye sobre este archivo, lo que lo convierte en uno de los componentes más importantes de todo el sistema.

📎 Related Topics