O que é application.yaml no MagicTradeBot?

O que é application.yaml?

application.yaml é o arquivo de configuração principal que controla como o MagicTradeBot inicia, conecta-se às exchanges, identifica-se e opera em nível de sistema.

Pense nele como a configuração de inicialização do MagicTradeBot — antes que qualquer estratégia, Market Watch ou lógica do mecanismo de decisão seja executada, o bot lê este arquivo para entender:

  • A qual exchange se conectar
  • Como autenticar-se de forma segura
  • Se deve ser executado em modo de demonstração ou ao vivo
  • Qual licença usar
  • Comportamento básico de tempo de execução (depuração, nomenclatura, ambiente)

Sem um application.yaml válido, o MagicTradeBot não pode inicializar ou operar corretamente.

O que o application.yaml controla?

O arquivo application.yaml é responsável por configurações globais, não relacionadas à estratégia, incluindo:

  • Seleção da exchange e regras de compatibilidade
  • Autenticação da API (ou mapeamento de variáveis de ambiente)
  • Validação da licença
  • Identidade do bot e sinalizadores de tempo de execução
  • Comportamento de segurança e implantação

Ele NÃO define:

  • Estratégias de negociação
  • Regras de stop-loss / take-profit
  • Lógica do Market Watch
  • Regras de decisão DCA ou Brain

Essas são tratadas em arquivos de configuração separados e específicos de recursos, mantendo as responsabilidades limpas e modulares.

Seções principais explicadas

1. Configuração da exchange

Esta seção informa ao MagicTradeBot a qual exchange se conectar e como.

Principais responsabilidades:

  • Seleciona a exchange (binance, bybit, okx, bitget, hyperliquid)
  • Impõe a compatibilidade do modo de posição específico da exchange
  • Carrega as credenciais da API com segurança

O MagicTradeBot realiza uma validação rigorosa aqui para evitar:

  • Modos de posição incorretos (ex., Hedge vs One-Way)
  • Falha na execução de ordens
  • Cálculos de PnL incorretos
  • Incompatibilidades no gerenciamento de risco

Se uma exchange não suportada for configurada, o bot se recusará a operar.

2. Credenciais da API e segurança

application.yaml suporta dois métodos seguros para credenciais:

Opção A: YAML direto (recomendado apenas para demonstração/testes)

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

Opção B: Variáveis de ambiente (recomendado para produção)

As variáveis de ambiente substituem automaticamente os valores YAML.

Este design:

  • Previne a exposição acidental de chaves
  • Funciona perfeitamente com Docker, VPS e implantações em nuvem
  • Alinha-se com as melhores práticas de segurança empresarial

O MagicTradeBot nunca requer permissões de saque e avisa explicitamente contra elas.

3. Compatibilidade do modo de posição (Crítico)

Diferentes exchanges suportam diferentes modos de posição, e o MagicTradeBot impõe isso na inicialização.

Exemplos:

  • Bybit → Apenas modo One-Way
  • Binance / OKX / Bitget → Modo Hedge obrigatório

Se sua conta na exchange estiver mal configurada:

  • As ordens podem ser rejeitadas
  • TP/SL pode falhar
  • As posições podem fechar incorretamente

Essa validação existe para proteger o capital e garantir um comportamento determinístico.

4. Configuração da licença

A seção de Licença ativa sua instalação do MagicTradeBot.

License:
  Key: ""

A licença:

  • Desbloqueia recursos com base no seu plano
  • Controla a autorização da instância
  • É validada durante a inicialização

Sem uma chave de licença válida, o bot não entrará em modo operacional.

5. Configurações gerais do aplicativo

Esta seção controla como o bot se comporta em tempo de execução — não como ele negocia.

Opções principais:

  • BotName – Ajuda a identificar esta instância em logs, painéis e alertas
  • DemoMode – Habilita a negociação simulada sem fundos reais
  • DebugMode – Habilita o registro detalhado para diagnóstico

Essas configurações são especialmente úteis ao executar:

  • Múltiplas instâncias do bot
  • Ambientes de teste vs produção
  • Investigações de depuração ou suporte

Modo de demonstração vs Modo ao vivo

Um dos sinalizadores mais importantes em application.yaml é:

DemoMode: true
  • DemoMode = true → Nenhuma ordem real é colocada
  • DemoMode = false → A negociação ao vivo está habilitada

Isso permite que os usuários:

  • Testem configurações com segurança
  • Validem estratégias antes de arriscar capital
  • Executem o bot em simulação com dados de mercado reais

Por que o MagicTradeBot usa application.yaml

O MagicTradeBot usa application.yaml porque fornece:

  • Estrutura legível por humanos
  • Forte separação de responsabilidades
  • Padrões seguros para usuários iniciantes
  • Automação fácil via variáveis de ambiente
  • Compatibilidade com Docker, nuvem e implantações locais

Mais importante, garante um comportamento de inicialização previsível, essencial para um sistema de negociação automatizado.

Melhores práticas

  • ✔ Use variáveis de ambiente para chaves de API em produção
  • ✔ Mantenha o DemoMode ativado durante os testes
  • ✔ Verifique novamente o modo de posição da exchange antes de entrar ao vivo
  • ✔ Nunca ative permissões de saque nas chaves de API
  • ✔ Trate o application.yaml como configuração de infraestrutura, não configuração de estratégia

Resumo

application.yaml é a base do ambiente de execução do MagicTradeBot.

Ele define:

  • Onde o bot se conecta
  • Como ele se autentica
  • Se ele negocia ao vivo ou em demonstração
  • Qual licença está ativa
  • Quão seguramente ele funciona

Toda a inteligência avançada — como Smart SL/TP, Market Watch, DCA e o cérebro do MagicTradeBot — é construída sobre este arquivo, tornando-o um dos componentes mais importantes em todo o sistema.

📎 Related Topics