Guia de instalação

Pré-requisitos

• Docker Desktop (necessário apenas se usar Redis)
• Uma conta em exchange compatível com chaves de API
• O endereço IP público do seu servidor (para whitelist de API)

Sumário

1. Configuração do Bot
2. Configuração das Chaves de API
3. Configuração do Redis
4. RedisMarketBridge
5. Executando o Bot
6. Solução de Problemas
7. Integração com TradingView

1. Configuração do Bot

Toda a configuração é feita através do configurador online.

1. Acesse: Configurador
2. Selecione MagicTradeBot
3. Configure:

Exportar configurações:

1. Clique em Export All YAML
2. Descompacte o arquivo
3. Substitua a pasta /settings no projeto

magictradebot/
├── settings/  ← substituir
├── MagicTradeBot
├── MagicTradeBot.exe
└── .env

2. Configuração das Chaves de API

🔐 Segurança: Sempre use variáveis de ambiente. Nunca armazene chaves de API em arquivos de configuração.

Whitelist de IP

curl ifconfig.me

Adicione este IP à whitelist da API da sua exchange.

Usando .env

BINANCE_API_KEY=sua_chave
BINANCE_API_SECRET=seu_segredo

⚠️ Adicione o arquivo .env ao .gitignore

3. Configuração do Redis (Opcional)

Necessário apenas se o Redis estiver habilitado.

Executar Redis via Docker

docker run -d \
--name magictradebot-redis \
-p 6379:6379 \
--restart unless-stopped \
redis:latest

Verificar

docker exec -it magictradebot-redis redis-cli ping

Esperado: PONG

4. RedisMarketBridge

Este componente envia dados de mercado em tempo real para o Redis.

⚠️ Exchange + pares + intervalos DEVEM corresponder exatamente à configuração do bot

Passos:

1. Configure via configurador
2. Exporte o YAML
3. Substitua adapters/redismarketbridge/settings

5. Executando o Bot

Ordem de inicialização

1. Iniciar o Redis
2. Iniciar o RedisMarketBridge
3. Aguardar 2 minutos
4. Iniciar o MagicTradeBot

Linux / macOS

chmod +x MagicTradeBot
./MagicTradeBot

Windows

MagicTradeBot.exe

💡 Execute pelo terminal para ver os logs

6. Solução de Problemas

Erros de API

• Verifique a whitelist de IP
• Verifique permissões
• Confirme as variáveis de ambiente

Sem dados de mercado

• Aguarde 2 minutos após iniciar o RedisMarketBridge
• Verifique se a configuração está correta

Problemas com Redis

• Verifique se o Docker está rodando
• Porta 6379 aberta

7. Integração de Sinais com TradingView

O MagicTradeBot suporta sinais externos do TradingView via webhooks.

Como funciona

• TradingView envia alertas → webhook
• MagicTradeBot recebe os sinais
• O bot executa ordens automaticamente

Passo 1 — Ativar Webhook no Bot

No seu configurador:

• Ative Signals → Webhook
• Copie a URL do webhook

Exemplo:

http://seu-servidor:porta/webhook

Passo 2 — Criar Alerta no TradingView

1. Abra o gráfico no TradingView
2. Adicione seu indicador ou estratégia
3. Clique em Alert
4. Ative Webhook URL
5. Cole a URL do webhook do bot

Passo 3 — Definir Mensagem do Alerta

Exemplo de payload JSON:

{
  "symbol": "BTCUSDT",
  "action": "buy",
  "price": "{{close}}",
  "time": "{{time}}"
}

Ações suportadas

• buy
• sell
• close

Notas importantes

• Certifique-se de que o símbolo corresponde exatamente à configuração do bot
• Use alinhamento correto de timeframe
• Teste com pequenas operações primeiro

⚠️ Formato de payload incorreto = sinais ignorados

Teste

Você pode simular um webhook usando:

curl -X POST http://seu-servidor/webhook \
-H "Content-Type: application/json" \
-d '{"symbol":"BTCUSDT","action":"buy"}'

✅ Se configurado corretamente, o bot executará uma ordem

💡 Para mais detalhes, consulte a documentação oficial de integração do TradingView.