Guía del usuario — Configuración y gestión global del apalancamiento

Resumen

Esta guía explica cómo utilizar las opciones de configuración de apalancamiento en tradesettings.yaml bajo Configuraciones Generales para gestionar el apalancamiento en todos los símbolos de trading en tu exchange.

1. SetLeverageStartup

SetLeverageStartup: false

Propósito: Aplicar el apalancamiento definido a todos los símbolos de trading al iniciar el bot.

Cuándo Habilitar (true)

  • ✅ Configuración inicial: Cuando necesitas establecer el apalancamiento para todos los símbolos inicialmente
  • ✅ Tras cambiar la configuración de apalancamiento: Cuando has modificado el apalancamiento deseado
  • ✅ Tras añadir nuevos símbolos: Cuando se añaden nuevos pares de trading al exchange

Cuándo Deshabilitar (false)

  • ✅ Tras una actualización exitosa del apalancamiento: Para evitar llamadas innecesarias a la API
  • ✅ Operación normal: Para evitar reiniciar el apalancamiento en cada reinicio
  • ✅ Cuando el apalancamiento ya está configurado: Si todos los símbolos tienen el apalancamiento correcto

⚠️ Notas Importantes

  • Siempre configura a false después de que el apalancamiento se haya actualizado correctamente para evitar:
    • Llamadas innecesarias a la API en cada inicialización
    • Posibles limitaciones de tasa por parte del exchange
    • Tiempos de inicio más lentos
# Paso 1: Habilitar para actualizar el apalancamiento
SetLeverageStartup: true

# Paso 2: Iniciar el bot (se aplicará el apalancamiento)
# Paso 3: Detener el bot

# Paso 4: Deshabilitar antes del próximo inicio
SetLeverageStartup: false

Ejemplo de Flujo de Trabajo

1. Establece el apalancamiento deseado en la configuración (por ejemplo, 10x)
2. Habilita SetLeverageStartup: true
3. Inicia el bot → El apalancamiento se aplica a todos los símbolos
4. Detén el bot
5. Deshabilita SetLeverageStartup: false
6. Reinicia el bot para trading normal

2. SetMaxLeverage

SetMaxLeverage: false

Propósito: Utilizar automáticamente el apalancamiento máximo permitido por el exchange para cada símbolo en lugar del valor de apalancamiento configurado.

Cómo Funciona

Cuando es false (Predeterminado):

  • Usa el valor de apalancamiento configurado para todos los símbolos
  • Si no es compatible, la llamada a la API puede fallar

Cuando es true:

  • Obtiene el apalancamiento máximo soportado para cada símbolo
  • Usa el valor más bajo entre el configurado y el máximo del exchange

Escenarios de Ejemplo

# Escenario 1: El símbolo soporta tu apalancamiento
Tu configuración: 20x
Máximo del símbolo: 50x
Resultado:       20x

# Escenario 2: El símbolo tiene un apalancamiento máximo más bajo
Tu configuración: 20x
Máximo del símbolo: 5x
Resultado:       5x
Salida del bot:  "ℹ️ El apalancamiento máximo de XYZUSDT es 5x, usando 5x en lugar de 20x"

# Escenario 3: El símbolo tiene un apalancamiento máximo más alto
Tu configuración: 10x
Máximo del símbolo: 125x
Resultado:       10x

Cuándo Habilitar (true)

  • ✅ Enfoque seguro para evitar errores relacionados con el apalancamiento
  • ✅ Tipos de símbolos mixtos con límites de apalancamiento variables
  • ✅ Trading conservador para ajustarse automáticamente a los límites
  • ✅ Bots para múltiples exchanges con reglas diferentes

Cuándo Deshabilitar (false)

  • ✅ Apalancamiento uniforme soportado en todos los símbolos
  • ✅ La estrategia requiere valores exactos de apalancamiento
  • ✅ Optimización de rendimiento (menos llamadas a la API)

Integración con symbols.json

Flujo de Actualización de Apalancamiento

1. El bot lee el apalancamiento de tradesettings.yaml
2. Si SetMaxLeverage: true → Obtiene el apalancamiento máximo
3. Calcula el apalancamiento final (mínimo entre configurado y máximo)
4. Aplica el apalancamiento a través de la API del exchange
5. ✅ Actualiza symbols.json con el apalancamiento aplicado realmente
6. El bot usa el apalancamiento de symbols.json para el trading

Por qué es importante la actualización de symbols.json

  • Garantiza consistencia con el exchange
  • Persiste entre reinicios
  • Seguimiento visible del apalancamiento realmente utilizado

⚠️ Importante: Sincronización de Tiempo

# ❌ INCORRECTO
SetLeverageStartup: true
SetMaxLeverage: true

# ✅ CORRECTO (Actualización única)
SetLeverageStartup: true
SetMaxLeverage: true
# Después del éxito:
SetLeverageStartup: false
SetMaxLeverage: false

Flujos de Configuración Recomendados

Configuración Inicial (Bot Nuevo)

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: true
SetMaxLeverage: true
  1. Configura los ajustes anteriores
  2. Inicia el bot → Se aplica el apalancamiento y se actualiza symbols.json
  3. Detén el bot
  4. Deshabilita ambas configuraciones
  5. Reinicia para operación normal

Cambiar el Valor del Apalancamiento

# tradesettings.yaml
Leverage: 15
SetLeverageStartup: true
SetMaxLeverage: true
  1. Actualiza el valor del apalancamiento
  2. Habilita SetLeverageStartup
  3. Inicia el bot → Se aplica el nuevo apalancamiento
  4. Detén el bot
  5. Vuelve a deshabilitar antes del próximo inicio

Operación Normal (Recomendada)

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: false
SetMaxLeverage: false

El bot lee el apalancamiento de symbols.json (ya configurado y actualizado).

Añadir Nuevos Símbolos

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: true
SetMaxLeverage: true
  1. Añade nuevos símbolos al exchange
  2. Habilita SetLeverageStartup
  3. Inicia el bot → Se aplica el apalancamiento a todos los símbolos
  4. Detén el bot
  5. Deshabilita antes del trading normal

Solución de Problemas

  • Problema: El bot sigue reiniciando el apalancamiento
    Causa: SetLeverageStartup: true se dejó habilitado
    Solución: Configura a false después de la configuración inicial
  • Problema: El apalancamiento no se aplica
    Causa: SetLeverageStartup: false durante la actualización
    Solución: Habilita temporalmente y reinicia
  • Problema: Errores de API sobre límites de apalancamiento
    Causa: El apalancamiento configurado excede el máximo del exchange
    Solución: Habilita SetMaxLeverage: true
  • Problema: Inconsistencia en symbols.json
    Causa: Cambio manual o desincronización
    Solución: Habilita SetLeverageStartup: true una vez para resincronizar

Mejores Prácticas

✅ HAZ

  • Configura SetLeverageStartup: false después de actualizaciones exitosas
  • Usa SetMaxLeverage: true para la configuración inicial
  • Verifica los valores de apalancamiento en symbols.json
  • Mantén copias de seguridad antes de los cambios
  • Prueba en un símbolo antes de aplicarlo a todos

❌ NO HAGAS

  • Dejar SetLeverageStartup: true en operación normal
  • Cambiar el apalancamiento sin habilitar SetLeverageStartup
  • Editar symbols.json manualmente
  • Habilitar ambos repetidamente (causa sobrecarga de API)

Tabla de Referencia Rápida

Escenario SetLeverageStartup SetMaxLeverage Cuándo Usar
Configuración inicial true true Primera vez que ejecutas el bot
Trading normal false false Operación diaria
Cambiar apalancamiento true true Tras modificar el valor del apalancamiento
Añadir nuevos símbolos true true Nuevos pares añadidos al exchange
Modo conservador false true Ajuste automático a los límites del exchange
Modo de rendimiento false false Minimizar llamadas a la API

Soporte

  1. Revisa los registros del bot en busca de errores
  2. Verifica que los permisos de la API del exchange incluyan la modificación del apalancamiento
  3. Asegúrate de que todos los símbolos existan en el exchange
  4. Revisa symbols.json para confirmar el apalancamiento correcto
  5. Revisa los límites de apalancamiento específicos del exchange

📎 Related Topics