Guida all'installazione

Prerequisiti

• Docker Desktop (richiesto solo se si utilizza Redis)
• Un account exchange supportato con chiavi API
• L’indirizzo IP pubblico del tuo server (per la whitelist API)

Indice

1. Configurazione del Bot
2. Configurazione delle Chiavi API
3. Configurazione Redis
4. RedisMarketBridge
5. Avvio del Bot
6. Risoluzione dei Problemi
7. Integrazione TradingView

1. Configurazione del Bot

Tutta la configurazione viene effettuata tramite il configuratore online.

1. Apri: Configuratore
2. Seleziona MagicTradeBot
3. Configura:

Esportazione impostazioni:

1. Clicca Export All YAML
2. Estrai lo ZIP
3. Sostituisci la cartella /settings nel progetto

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

2. Configurazione Chiavi API

🔐 Sicurezza: Usa sempre variabili d’ambiente. Non salvare mai le chiavi API nei file di configurazione.

Whitelist IP

curl ifconfig.me

Aggiungi questo IP alla whitelist API del tuo exchange.

Uso del file .env

BINANCE_API_KEY=your_key
BINANCE_API_SECRET=your_secret

⚠️ Aggiungi .env a .gitignore

3. Configurazione Redis (Opzionale)

Necessario solo se Redis è abilitato.

Eseguire Redis con Docker

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

Verifica

docker exec -it magictradebot-redis redis-cli ping

Risultato atteso: PONG

4. RedisMarketBridge

Questo componente invia dati di mercato in tempo reale a Redis.

⚠️ Exchange + coppie + intervalli DEVONO corrispondere esattamente alla configurazione del bot

Passaggi:

1. Configura tramite configuratore
2. Esporta YAML
3. Sostituisci adapters/redismarketbridge/settings

5. Avvio del Bot

Ordine di avvio

1. Avvia Redis
2. Avvia RedisMarketBridge
3. Attendi 2 minuti
4. Avvia MagicTradeBot

Linux / macOS

chmod +x MagicTradeBot
./MagicTradeBot

Windows

MagicTradeBot.exe

💡 Avvia dal terminale per vedere i log

6. Risoluzione dei Problemi

Errori API

• Controlla whitelist IP
• Controlla permessi
• Verifica variabili d’ambiente

Nessun dato di mercato

• Attendi 2 minuti dopo l’avvio di RedisMarketBridge
• Controlla che la configurazione sia coerente

Problemi Redis

• Verifica che Docker sia in esecuzione
• Porta 6379 aperta

7. Integrazione Segnali TradingView

MagicTradeBot supporta segnali esterni da TradingView tramite webhook.

Come funziona

• TradingView invia alert → webhook
• MagicTradeBot riceve i segnali
• Il bot esegue operazioni automaticamente

Passo 1 — Abilitare Webhook nel Bot

Nella configurazione del bot:

• Abilita Signals → Webhook
• Copia l’URL del webhook

Esempio:

http://your-server:port/webhook

Passo 2 — Creare Alert su TradingView

1. Apri il grafico su TradingView
2. Aggiungi indicatore o strategia
3. Clicca Alert
4. Abilita Webhook URL
5. Incolla l’URL del webhook del bot

Passo 3 — Definire il Messaggio Alert

Esempio payload JSON:

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

Azioni supportate

• buy
• sell
• close

Note importanti

• Assicurati che il simbolo corrisponda esattamente alla configurazione del bot
• Usa il corretto allineamento dei timeframe
• Testa prima con piccoli trade

⚠️ Formato payload errato = segnali ignorati

Test

Puoi simulare un webhook usando:

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

✅ Se configurato correttamente, il bot eseguirà una trade

💡 Per dettagli completi, consulta la documentazione ufficiale di integrazione TradingView.