Quais configurações devem ser feitas antes de rodar o MagicTradeBot pela primeira vez?

  • Home
  • Documentation
  • Quais configurações devem ser feitas antes de rodar o MagicTradeBot pela primeira vez?

Guia de configuração inicial

Antes de iniciar o MagicTradeBot pela primeira vez, um pequeno conjunto de configurações obrigatórias e recomendadas deve ser definido para garantir que o bot inicie corretamente, conecte-se com segurança à sua exchange e opere sem erros.

O MagicTradeBot é projetado com padrões seguros, então você não precisa configurar todos os arquivos antecipadamente. As etapas abaixo cobrem a configuração mínima necessária e recomendada para uma primeira execução tranquila.

1. Configurar a exchange no application.yaml

Você deve especificar a qual exchange o MagicTradeBot se conectará.

Exchange:
  Name: "bybit"

Exchanges suportadas:

  • Binance
  • Bybit
  • OKX
  • Bitget
  • Hyperliquid

⚠️ Importante: Cada exchange tem requisitos rigorosos de modo de posição (One-Way vs Hedge). Certifique-se de que sua conta na exchange esteja configurada adequadamente antes de executar o bot.

2. Definir as credenciais da API da exchange (Obrigatório)

O MagicTradeBot precisa de acesso à API para colocar e gerenciar negociações.

Método recomendado: Variáveis de ambiente (Melhor prática)

O uso de variáveis de ambiente é altamente recomendado, especialmente para produção, porque:

  • As chaves da API não são armazenadas em arquivos
  • As chaves são mais seguras e fáceis de rotacionar
  • As variáveis de ambiente substituem automaticamente os valores YAML

Configuração de variáveis de ambiente por SO

✅ Windows (PowerShell)
setx BINANCE_API_KEY "sua_chave_api_aqui"
setx BINANCE_API_SECRET "seu_segredo_api_aqui"

Reinicie o terminal (ou o sistema) após definir as variáveis.

✅ Linux / macOS (Terminal)
export BINANCE_API_KEY="sua_chave_api_aqui"
export BINANCE_API_SECRET="seu_segredo_api_aqui"

Para torná-las permanentes, adicione as linhas a:

  • ~/.bashrc
  • ~/.zshrc
  • Seu arquivo de perfil do shell
✅ Docker / Docker Compose
environment:
  - BINANCE_API_KEY=${BINANCE_API_KEY}
  - BINANCE_API_SECRET=${BINANCE_API_SECRET}

Nomes de variáveis de ambiente suportados

Exemplos:

  • 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 ative permissões de saque nas chaves da API.

3. Fornecer sua chave de licença

No application.yaml:

License:
  Key: "sua_chave_de_licenca_aqui"

Como obter sua chave de licença

  1. Faça login em https://magictradebot.com
  2. Vá para Downloads
  3. Copie sua chave de licença

Notas importantes

  • O bot pode funcionar sem uma licença
  • No entanto, os recursos serão limitados
  • A validação da licença ocorre na inicialização

4. Revisar as configurações básicas de negociação (trading.yaml)

Para usuários iniciantes, este arquivo não requer alterações obrigatórias.

Opcionalmente, você pode revisar ou ajustar:

  • Valor inicial de negociação
  • Alavancagem padrão
  • Limites de risco

Se não tiver certeza, mantenha os padrões — eles são seguros para execuções iniciais e modo de demonstração.

5. Configuração inicial de símbolos e alavancagem (Muito importante)

Etapa 1: Ativar a sincronização de símbolos (Apenas na primeira execução)

No trading.yaml (ou arquivo de configuração de símbolos):

SyncSymbolsOnStartup: true

Isso irá:

  • Buscar todos os símbolos suportados da exchange
  • Criar ou atualizar symbols.json
  • Remover símbolos delistados
  • Adicionar símbolos recém-listados

➡️ Execute o bot e aguarde até que a sincronização de símbolos seja concluída
➡️ Monitore o arquivo symbols.json
➡️ Pare o bot assim que a sincronização terminar

Etapa 2: Desativar a sincronização de símbolos (Opcional)

Após a primeira sincronização, você pode definir:

SyncSymbolsOnStartup: false

Se você quiser atualizações automáticas de símbolos, mantenha-o como true permanentemente.

Etapa 3: Configuração única de alavancagem (Opcional, mas recomendada)

Se você quiser que o MagicTradeBot configure a alavancagem automaticamente:

SetLeverageStartup: true
SetMaxLeverage: false
  • Isso aplica sua alavancagem configurada (ex., 10x) a todos os símbolos suportados
  • Execute o bot uma vez
  • Aguarde alguns minutos para as atualizações de alavancagem
  • Em seguida, defina ambas as opções de volta para false

⚠️ NÃO deixe essas opções ativadas permanentemente, ou a alavancagem será redefinida a cada reinicialização.

Alavancagem máxima (Caso de uso para scalping)

Se você deseja a alavancagem máxima permitida pela exchange:

SetMaxLeverage: true

Use isso apenas uma vez e depois desative novamente.

6. Escolher símbolos para negociar (Opcional)

Você pode:

  • Negociar todos os símbolos sincronizados (500+)
  • Ou restringir a negociação apenas a símbolos selecionados

Exemplo:

BTCUSDT
ETHUSDT
SOLUSDT
XRPUSDT

Se estiver negociando todos os símbolos, mantenha:

SyncSymbolsOnStartup: true

7. Configurar notificações (Altamente recomendado)

Configure pelo menos um canal de notificação no notification.yaml:

  • Telegram
  • Discord

Isso permite que você receba:

  • Execuções de negociações
  • Erros e falhas
  • Alertas do Market Watch
  • Eventos de emergência

Operar sem notificações é possível, mas não é recomendado.

Lista de verificação final (Primeira execução)

Antes de iniciar o MagicTradeBot, certifique-se de:

  • ✅ Exchange selecionada no application.yaml
  • ✅ Credenciais da API definidas (preferencialmente via variáveis de ambiente)
  • ✅ Chave de licença adicionada (opcional, mas recomendada)
  • ✅ Sincronização de símbolos ativada para a primeira execução
  • ✅ Configuração opcional de alavancagem concluída uma vez
  • ✅ Canal de notificação configurado

É isso.
Nenhuma outra configuração é necessária para começar a negociar com segurança e corretamente.

📎 Related Topics