Guia do usuário — Configuração e gerenciamento global de alavancagem

Visão Geral

Este guia explica como usar as opções de configuração de alavancagem em tradesettings.yaml sob Configurações Gerais para gerenciar a alavancagem em todos os símbolos de negociação na sua exchange.

1. SetLeverageStartup

SetLeverageStartup: false

Objetivo: Aplicar a alavancagem definida a todos os símbolos de negociação ao iniciar o bot.

Quando Ativar (true)

  • ✅ Configuração inicial: Quando você precisa definir a alavancagem para todos os símbolos inicialmente
  • ✅ Após alterar configurações de alavancagem: Quando você modificou a alavancagem desejada
  • ✅ Após adicionar novos símbolos: Quando novos pares de negociação são adicionados à exchange

Quando Desativar (false)

  • ✅ Após atualização bem-sucedida da alavancagem: Para evitar chamadas desnecessárias à API
  • ✅ Operação normal: Para evitar redefinir a alavancagem a cada reinício
  • ✅ Quando a alavancagem já está configurada: Se todos os símbolos já possuem a alavancagem correta

⚠️ Notas Importantes

  • Sempre defina como false após a alavancagem ser atualizada com sucesso para evitar:
    • Chamadas desnecessárias à API em cada inicialização
    • Possível limitação de taxa pela exchange
    • Tempos de inicialização mais lentos
# Passo 1: Ativar para atualizar a alavancagem
SetLeverageStartup: true

# Passo 2: Iniciar o bot (a alavancagem será aplicada)
# Passo 3: Parar o bot

# Passo 4: Desativar antes do próximo início
SetLeverageStartup: false

Exemplo de Fluxo de Trabalho

1. Definir a alavancagem desejada na configuração (ex., 10x)
2. Ativar SetLeverageStartup: true
3. Iniciar o bot → Alavancagem aplicada a todos os símbolos
4. Parar o bot
5. Desativar SetLeverageStartup: false
6. Reiniciar o bot para negociação normal

2. SetMaxLeverage

SetMaxLeverage: false

Objetivo: Usar automaticamente a alavancagem máxima permitida pela exchange para cada símbolo, em vez do valor de alavancagem configurado.

Como Funciona

Quando false (Padrão):

  • Usa o valor de alavancagem configurado para todos os símbolos
  • Se não suportado, a chamada à API pode falhar

Quando true:

  • Busca a alavancagem máxima suportada para cada símbolo
  • Usa o menor valor entre o configurado e o máximo da exchange

Exemplos de Cenários

# Cenário 1: Símbolo Suporta Sua Alavancagem
Sua Configuração: 20x
Máximo do Símbolo: 50x
Resultado:        20x

# Cenário 2: Símbolo Tem Alavancagem Máxima Menor
Sua Configuração: 20x
Máximo do Símbolo: 5x
Resultado:        5x
Saída do Bot:     "ℹ️ XYZUSDT alavancagem máxima é 5x, usando 5x em vez de 20x"

# Cenário 3: Símbolo Tem Alavancagem Máxima Maior
Sua Configuração: 10x
Máximo do Símbolo: 125x
Resultado:        10x

Quando Ativar (true)

  • ✅ Abordagem segura para evitar erros relacionados à alavancagem
  • ✅ Tipos de símbolos mistos com limites de alavancagem variados
  • ✅ Negociação conservadora para ajustar automaticamente aos limites
  • ✅ Bots em múltiplas exchanges com regras diferentes

Quando Desativar (false)

  • ✅ Alavancagem uniforme suportada em todos os símbolos
  • ✅ Estratégia requer valores exatos de alavancagem
  • ✅ Otimização de desempenho (menos chamadas à API)

Integração com symbols.json

Fluxo de Atualização de Alavancagem

1. Bot lê a alavancagem de tradesettings.yaml
2. Se SetMaxLeverage: true → Busca a alavancagem máxima
3. Calcula a alavancagem final (mínimo entre configurada e máxima)
4. Aplica a alavancagem via API da exchange
5. ✅ Atualiza symbols.json com a alavancagem realmente aplicada
6. Bot usa a alavancagem de symbols.json para negociação

Por que a Atualização de symbols.json é Importante

  • Garante consistência com a exchange
  • Persiste entre reinícios
  • Rastreamento visível da alavancagem realmente usada

⚠️ Importante: Tempo de Sincronização

# ❌ ERRADO
SetLeverageStartup: true
SetMaxLeverage: true

# ✅ CORRETO (Atualização única)
SetLeverageStartup: true
SetMaxLeverage: true
# Após sucesso:
SetLeverageStartup: false
SetMaxLeverage: false

Fluxos de Configuração Recomendados

Configuração Inicial (Novo Bot)

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: true
SetMaxLeverage: true
  1. Configurar as opções acima
  2. Iniciar o bot → Alavancagem aplicada e symbols.json atualizado
  3. Parar o bot
  4. Desativar ambas as configurações
  5. Reiniciar para operação normal

Alterando o Valor de Alavancagem

# tradesettings.yaml
Leverage: 15
SetLeverageStartup: true
SetMaxLeverage: true
  1. Atualizar o valor de alavancagem
  2. Ativar SetLeverageStartup
  3. Iniciar o bot → Nova alavancagem aplicada
  4. Parar o bot
  5. Desativar novamente antes do próximo início

Operação Normal (Recomendada)

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

O bot lê a alavancagem de symbols.json (já configurado e atualizado).

Adicionando Novos Símbolos

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: true
SetMaxLeverage: true
  1. Adicionar novos símbolos à exchange
  2. Ativar SetLeverageStartup
  3. Iniciar o bot → Alavancagem aplicada a todos os símbolos
  4. Parar o bot
  5. Desativar antes da negociação normal

Solução de Problemas

  • Problema: O bot continua redefinindo a alavancagem
    Causa: SetLeverageStartup: true deixado ativado
    Solução: Definir como false após a configuração inicial
  • Problema: Alavancagem não aplicada
    Causa: SetLeverageStartup: false durante a atualização
    Solução: Ativar temporariamente e reiniciar
  • Problema: Erros de API sobre limites de alavancagem
    Causa: Alavancagem configurada excede o máximo da exchange
    Solução: Ativar SetMaxLeverage: true
  • Problema: Inconsistência em symbols.json
    Causa: Alteração manual ou dessincronização
    Solução: Ativar SetLeverageStartup: true uma vez para ressincronizar

Melhores Práticas

✅ FAÇA

  • Definir SetLeverageStartup: false após atualizações bem-sucedidas
  • Usar SetMaxLeverage: true na configuração inicial
  • Verificar os valores de alavancagem em symbols.json
  • Manter backups antes de alterações
  • Testar em um símbolo antes de todos

❌ NÃO FAÇA

  • Deixar SetLeverageStartup: true na operação normal
  • Alterar a alavancagem sem ativar SetLeverageStartup
  • Editar symbols.json manualmente
  • Ativar ambos repetidamente (causa sobrecarga na API)

Tabela de Referência Rápida

Cenário SetLeverageStartup SetMaxLeverage Quando Usar
Configuração inicial true true Primeira execução do bot
Negociação normal false false Operação diária
Alterar alavancagem true true Após modificar o valor de alavancagem
Adicionar novos símbolos true true Novos pares adicionados à exchange
Modo conservador false true Ajustar automaticamente aos limites da exchange
Modo de desempenho false false Minimizar chamadas à API

Suporte

  1. Verificar os logs do bot para erros
  2. Confirmar que as permissões da API da exchange incluem modificação de alavancagem
  3. Garantir que todos os símbolos existem na exchange
  4. Verificar symbols.json para alavancagem correta
  5. Revisar os limites de alavancagem específicos da exchange

📎 Related Topics