Quali impostazioni devono essere configurate prima di eseguire MagicTradeBot per la prima volta?

  • Home
  • Documentation
  • Quali impostazioni devono essere configurate prima di eseguire MagicTradeBot per la prima volta?

Guida alla configurazione iniziale

Prima di avviare MagicTradeBot per la prima volta, è necessario configurare un piccolo insieme di impostazioni obbligatorie e consigliate per garantire che il bot parta correttamente, si connetta in modo sicuro al tuo exchange e funzioni senza errori.

MagicTradeBot è progettato con impostazioni predefinite sicure, quindi non è necessario configurare ogni file in anticipo. I passaggi seguenti coprono la configurazione minima richiesta e consigliata per un primo avvio senza intoppi.

1. Configurare l'exchange in application.yaml

Devi specificare a quale exchange si collegherà MagicTradeBot.

Exchange:
  Name: "bybit"

Exchange supportati:

  • Binance
  • Bybit
  • OKX
  • Bitget
  • Hyperliquid

⚠️ Importante: Ogni exchange ha requisiti rigorosi per la modalità di posizione (One-Way vs Hedge). Assicurati che il tuo account exchange sia configurato di conseguenza prima di eseguire il bot.

2. Impostare le credenziali API dell'exchange (Obbligatorio)

MagicTradeBot necessita di accesso API per piazzare e gestire le operazioni.

Metodo consigliato: Variabili d'ambiente (Buona prassi)

L'uso di variabili d'ambiente è fortemente consigliato, specialmente per la produzione, perché:

  • Le chiavi API non vengono memorizzate nei file
  • Le chiavi sono più sicure e più facili da ruotare
  • Le variabili d'ambiente sovrascrivono automaticamente i valori YAML

Configurazione delle variabili d'ambiente per sistema operativo

✅ Windows (PowerShell)
setx BINANCE_API_KEY "tua_chiave_api_qui"
setx BINANCE_API_SECRET "tuo_segreto_api_qui"

Riavvia il terminale (o il sistema) dopo aver impostato le variabili.

✅ Linux / macOS (Terminale)
export BINANCE_API_KEY="tua_chiave_api_qui"
export BINANCE_API_SECRET="tuo_segreto_api_qui"

Per renderle permanenti, aggiungi le righe a:

  • ~/.bashrc
  • ~/.zshrc
  • Il tuo file del profilo shell
✅ Docker / Docker Compose
environment:
  - BINANCE_API_KEY=${BINANCE_API_KEY}
  - BINANCE_API_SECRET=${BINANCE_API_SECRET}

Nomi di variabili d'ambiente supportati

Esempi:

  • 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

🔐 Non abilitare mai i permessi di prelievo sulle chiavi API.

3. Fornire la tua chiave di licenza

In application.yaml:

License:
  Key: "tua_chiave_licenza_qui"

Come ottenere la tua chiave di licenza

  1. Accedi a https://magictradebot.com
  2. Vai su Download
  3. Copia la tua chiave di licenza

Note importanti

  • Il bot può funzionare anche senza licenza
  • Tuttavia, le funzionalità saranno limitate
  • La convalida della licenza avviene all'avvio

4. Rivedere le impostazioni di trading di base (trading.yaml)

Per i nuovi utenti, questo file non richiede modifiche obbligatorie.

Puoi eventualmente rivedere o regolare:

  • Importo di trading iniziale
  • Leva predefinita
  • Limiti di rischio

In caso di dubbi, lascia le impostazioni predefinite — sono sicure per le prime esecuzioni e la modalità demo.

5. Configurazione iniziale di simboli e leva (Molto importante)

Passo 1: Abilitare la sincronizzazione dei simboli (Solo al primo avvio)

In trading.yaml (o nel file di configurazione dei simboli):

SyncSymbolsOnStartup: true

Questo:

  • Recupererà tutti i simboli supportati dall'exchange
  • Creerà o aggiornerà symbols.json
  • Rimuoverà i simboli delistati
  • Aggiungerà i simboli di nuova quotazione

➡️ Avvia il bot e attendi il completamento della sincronizzazione dei simboli
➡️ Monitora il file symbols.json
➡️ Ferma il bot una volta completata la sincronizzazione

Passo 2: Disabilitare la sincronizzazione dei simboli (Opzionale)

Dopo la prima sincronizzazione, puoi impostare:

SyncSymbolsOnStartup: false

Se desideri aggiornamenti automatici dei simboli, mantienilo su true in modo permanente.

Passo 3: Configurazione una tantum della leva (Opzionale ma consigliata)

Se vuoi che MagicTradeBot configuri automaticamente la leva:

SetLeverageStartup: true
SetMaxLeverage: false
  • Questo applica la leva configurata (es. 10x) a tutti i simboli supportati
  • Esegui il bot una volta
  • Aspetta qualche minuto per gli aggiornamenti della leva
  • Poi reimposta entrambe le opzioni su false

⚠️ NON lasciare queste opzioni abilitate in modo permanente, altrimenti la leva verrà resettata ad ogni riavvio.

Leva massima (Caso d'uso per lo scalping)

Se desideri la leva massima consentita dall'exchange:

SetMaxLeverage: true

Usa questa opzione solo una volta, poi disabilitala di nuovo.

6. Scegliere i simboli da tradare (Opzionale)

Puoi:

  • Fare trading su tutti i simboli sincronizzati (500+)
  • O limitare il trading solo a simboli selezionati

Esempio:

BTCUSDT
ETHUSDT
SOLUSDT
XRPUSDT

Se fai trading su tutti i simboli, mantieni:

SyncSymbolsOnStartup: true

7. Configurare le notifiche (Altamente consigliato)

Configura almeno un canale di notifica in notification.yaml:

  • Telegram
  • Discord

Questo ti permette di ricevere:

  • Esecuzioni di operazioni
  • Errori e fallimenti
  • Avvisi di Market Watch
  • Eventi di emergenza

È possibile operare senza notifiche, ma non è consigliato.

Lista di controllo finale (Primo avvio)

Prima di avviare MagicTradeBot, assicurati:

  • ✅ Exchange selezionato in application.yaml
  • ✅ Credenziali API impostate (preferibilmente tramite variabili d'ambiente)
  • ✅ Chiave di licenza aggiunta (opzionale ma consigliata)
  • ✅ Sincronizzazione simboli abilitata per il primo avvio
  • ✅ Configurazione opzionale della leva completata una volta
  • ✅ Canale di notifica configurato

Questo è tutto.
Non è richiesta alcuna altra configurazione per iniziare a fare trading in modo sicuro e corretto.

📎 Related Topics