¿Qué ajustes deben configurarse antes de ejecutar MagicTradeBot por primera vez?

Guía de configuración inicial

Antes de iniciar MagicTradeBot por primera vez, es necesario configurar un pequeño conjunto de ajustes obligatorios y recomendados para garantizar que el bot se inicie correctamente, se conecte de forma segura a su exchange y funcione sin errores.

MagicTradeBot está diseñado con valores predeterminados seguros, por lo que no es necesario configurar todos los archivos de antemano. Los siguientes pasos cubren la configuración mínima requerida y recomendada para un primer inicio sin problemas.

1. Configurar el exchange en application.yaml

Debe especificar a qué exchange se conectará MagicTradeBot.

Exchange:
  Name: "bybit"

Exchanges compatibles:

Binance
Bybit
OKX
Bitget
Hyperliquid

⚠️ Importante: Cada exchange tiene requisitos estrictos de modo de posición (One-Way vs Hedge). Asegúrese de que su cuenta de exchange esté configurada en consecuencia antes de ejecutar el bot.

2. Establecer las credenciales de la API del exchange (Obligatorio)

MagicTradeBot necesita acceso a la API para colocar y gestionar operaciones.

Método recomendado: Variables de entorno (Mejor práctica)

Se recomienda encarecidamente el uso de variables de entorno, especialmente para producción, porque:

Las claves de API no se almacenan en archivos
Las claves son más seguras y fáciles de rotar
Las variables de entorno anulan automáticamente los valores YAML

Configuración de variables de entorno por SO

✅ Windows (PowerShell)

setx BINANCE_API_KEY "tu_clave_api_aquí"
setx BINANCE_API_SECRET "tu_secreto_api_aquí"

Reinicie la terminal (o el sistema) después de establecer las variables.

✅ Linux / macOS (Terminal)

export BINANCE_API_KEY="tu_clave_api_aquí"
export BINANCE_API_SECRET="tu_secreto_api_aquí"

Para hacerlas permanentes, agregue las líneas a:

~/.bashrc
~/.zshrc
Su archivo de perfil de shell

✅ Docker / Docker Compose

environment:
  - BINANCE_API_KEY=${BINANCE_API_KEY}
  - BINANCE_API_SECRET=${BINANCE_API_SECRET}

Nombres de variables de entorno compatibles

Ejemplos:

BINANCE_API_KEY, BINANCE_API_SECRET
BYBIT_API_KEY, BYBIT_API_SECRET
OKX_API_KEY, OKX_API_SECRET, OKX_PASSPHRASE
BITGET_API_KEY, BITGET_API_SECRET, BITGET_PASSPHRASE
HYPERLIQUID_PRIVATE_KEY

🔐 Nunca active los permisos de retiro en las claves de API.

3. Proporcione su clave de licencia

En application.yaml:

License:
  Key: "tu_clave_de_licencia_aquí"

Cómo obtener su clave de licencia

Inicie sesión en https://magictradebot.com
Vaya a Descargas
Copie su clave de licencia

Notas importantes

El bot aún puede funcionar sin licencia
Sin embargo, las funciones serán limitadas
La validación de la licencia se realiza al inicio

4. Revisar la configuración básica de trading (trading.yaml)

Para los usuarios primerizos, este archivo no requiere cambios obligatorios.

Opcionalmente, puede revisar o ajustar:

Cantidad de trading inicial
Apalancamiento predeterminado
Límites de riesgo

Si no está seguro, deje los valores predeterminados; son seguros para las primeras ejecuciones y el modo demo.

5. Configuración inicial de símbolos y apalancamiento (Muy importante)

Paso 1: Habilitar la sincronización de símbolos (Solo en la primera ejecución)

En trading.yaml (o archivo de configuración de símbolos):

SyncSymbolsOnStartup: true

Esto:

Obtendrá todos los símbolos compatibles del exchange
Creará o actualizará symbols.json
Eliminará los símbolos excluidos de la lista
Agregará símbolos recién incluidos en la lista

➡️ Ejecute el bot y espere hasta que se complete la sincronización de símbolos
➡️ Supervise el archivo symbols.json
➡️ Detenga el bot una vez que se complete la sincronización

Paso 2: Deshabilitar la sincronización de símbolos (Opcional)

Después de la primera sincronización, puede establecer:

SyncSymbolsOnStartup: false

Si desea actualizaciones automáticas de símbolos, manténgalo como true de forma permanente.

Paso 3: Configuración única de apalancamiento (Opcional pero recomendado)

Si desea que MagicTradeBot configure el apalancamiento automáticamente:

SetLeverageStartup: true
SetMaxLeverage: false

Esto aplica su apalancamiento configurado (ej., 10x) a todos los símbolos compatibles
Ejecute el bot una vez
Espere unos minutos para que se actualice el apalancamiento
Luego, vuelva a establecer ambas opciones en false

⚠️ NO deje estas opciones habilitadas permanentemente, o el apalancamiento se restablecerá en cada reinicio.

Apalancamiento máximo (Caso de uso de scalping)

Si desea el apalancamiento máximo permitido por el exchange:

SetMaxLeverage: true

Use esto solo una vez y luego desactívelo nuevamente.

6. Elegir símbolos para operar (Opcional)

Puede:

Operar con todos los símbolos sincronizados (500+)
O restringir el trading solo a símbolos seleccionados

Ejemplo:

BTCUSDT
ETHUSDT
SOLUSDT
XRPUSDT

Si opera con todos los símbolos, mantenga:

SyncSymbolsOnStartup: true

7. Configurar notificaciones (Altamente recomendado)

Configure al menos un canal de notificación en notification.yaml:

Telegram
Discord

Esto le permite recibir:

Ejecuciones de operaciones
Errores y fallos
Alertas de Market Watch
Eventos de emergencia

Operar sin notificaciones es posible, pero no se recomienda.

Lista de verificación final (Primera ejecución)

Antes de iniciar MagicTradeBot, asegúrese de:

✅ Exchange seleccionado en application.yaml
✅ Credenciales de API establecidas (preferiblemente mediante variables de entorno)
✅ Clave de licencia agregada (opcional pero recomendada)
✅ Sincronización de símbolos habilitada para la primera ejecución
✅ Configuración opcional de apalancamiento completada una vez
✅ Canal de notificación configurado

Eso es todo.
No se requiere ninguna otra configuración para comenzar a operar de forma segura y correcta.