Cos'è application.yaml in MagicTradeBot?

Cos'è application.yaml?

application.yaml è il file di configurazione principale che controlla come MagicTradeBot si avvia, si connette agli exchange, si identifica e opera a livello di sistema.

Pensalo come la configurazione di avvio di MagicTradeBot — prima che qualsiasi strategia, Market Watch o logica del motore decisionale venga eseguita, il bot legge questo file per capire:

  • A quale exchange connettersi
  • Come autenticarsi in modo sicuro
  • Se deve funzionare in modalità demo o live
  • Quale licenza utilizzare
  • Il comportamento di base dell'esecuzione (debug, denominazione, ambiente)

Senza un application.yaml valido, MagicTradeBot non può inizializzarsi o funzionare correttamente.

Cosa controlla application.yaml?

Il file application.yaml è responsabile delle impostazioni globali, non legate alla strategia, inclusi:

  • Selezione dell'exchange e regole di compatibilità
  • Autenticazione API (o mappatura delle variabili d'ambiente)
  • Convalida della licenza
  • Identità del bot e flag di esecuzione
  • Comportamento di sicurezza e distribuzione

NON definisce:

  • Le strategie di trading
  • Le regole di stop-loss / take-profit
  • La logica di Market Watch
  • Le regole decisionali DCA o Brain

Queste sono gestite in file di configurazione separati e specifici per funzione, mantenendo le responsabilità pulite e modulari.

Spiegazione delle sezioni chiave

1. Configurazione dell'exchange

Questa sezione indica a MagicTradeBot a quale exchange connettersi e come.

Responsabilità chiave:

  • Seleziona l'exchange (binance, bybit, okx, bitget, hyperliquid)
  • Applica la compatibilità della modalità di posizione specifica dell'exchange
  • Carica in modo sicuro le credenziali API

MagicTradeBot esegue qui una convalida rigorosa per prevenire:

  • Modalità di posizione errate (es. Hedge vs One-Way)
  • Esecuzione di ordini fallita
  • Calcoli PnL errati
  • Disallineamenti nella gestione del rischio

Se viene configurato un exchange non supportato, il bot rifiuterà di operare.

2. Credenziali API e sicurezza

application.yaml supporta due metodi sicuri per le credenziali:

Opzione A: YAML diretto (consigliato solo per demo/test)

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

Opzione B: Variabili d'ambiente (consigliato per la produzione)

Le variabili d'ambiente sovrascrivono automaticamente i valori YAML.

Questo design:

  • Previene l'esposizione accidentale delle chiavi
  • Funziona perfettamente con Docker, VPS e distribuzioni cloud
  • Si allinea con le migliori pratiche di sicurezza aziendali

MagicTradeBot non richiede mai autorizzazioni di prelievo e mette esplicitamente in guardia contro di esse.

3. Compatibilità della modalità di posizione (Critica)

Diversi exchange supportano diverse modalità di posizione e MagicTradeBot le applica all'avvio.

Esempi:

  • Bybit → Solo modalità One-Way
  • Binance / OKX / Bitget → Modalità Hedge richiesta

Se il tuo account exchange è configurato male:

  • Gli ordini potrebbero essere respinti
  • TP/SL potrebbe fallire
  • Le posizioni potrebbero chiudersi in modo errato

Questa convalida esiste per proteggere il capitale e garantire un comportamento deterministico.

4. Configurazione della licenza

La sezione Licenza attiva la tua installazione di MagicTradeBot.

License:
  Key: ""

La licenza:

  • Sblocca le funzionalità in base al tuo piano
  • Controlla l'autorizzazione dell'istanza
  • Viene convalidata all'avvio

Senza una chiave di licenza valida, il bot non entrerà in modalità operativa.

5. Impostazioni generali dell'applicazione

Questa sezione controlla come il bot si comporta in fase di esecuzione — non come fa trading.

Opzioni chiave:

  • BotName – Aiuta a identificare questa istanza in log, dashboard e avvisi
  • DemoMode – Abilita il trading simulato senza fondi reali
  • DebugMode – Abilita la registrazione dettagliata per la diagnostica

Queste impostazioni sono particolarmente utili quando si eseguono:

  • Più istanze di bot
  • Ambienti di staging vs produzione
  • Indagini di debug o supporto

Modalità demo vs modalità live

Uno dei flag più importanti in application.yaml è:

DemoMode: true
  • DemoMode = true → Non vengono effettuati ordini reali
  • DemoMode = false → Il trading live è abilitato

Ciò consente agli utenti di:

  • Testare le configurazioni in sicurezza
  • Convalidare le strategie prima di rischiare capitale
  • Eseguire il bot in simulazione su dati di mercato reali

Perché MagicTradeBot usa application.yaml

MagicTradeBot utilizza application.yaml perché fornisce:

  • Struttura leggibile dall'uomo
  • Forte separazione delle preoccupazioni
  • Impostazioni predefinite sicure per i nuovi utenti
  • Facile automazione tramite variabili d'ambiente
  • Compatibilità con Docker, cloud e distribuzioni on-premise

La cosa più importante è che garantisce un comportamento di avvio prevedibile, essenziale per un sistema di trading automatizzato.

Buone pratiche

  • ✔ Usa variabili d'ambiente per le chiavi API in produzione
  • ✔ Mantieni DemoMode abilitato durante i test
  • ✔ Ricontrolla la modalità di posizione dell'exchange prima di andare in live
  • ✔ Non abilitare mai le autorizzazioni di prelievo sulle chiavi API
  • ✔ Tratta application.yaml come configurazione dell'infrastruttura, non come configurazione della strategia

Riepilogo

application.yaml è il fondamento dell'ambiente di esecuzione di MagicTradeBot.

Definisce:

  • Dove il bot si connette
  • Come si autentica
  • Se fa trading in live o in demo
  • Quale licenza è attiva
  • Quanto è sicuro il suo funzionamento

Tutta l'intelligenza avanzata — come Smart SL/TP, Market Watch, DCA e il cervello di MagicTradeBot — è costruita sopra questo file, rendendolo uno dei componenti più importanti dell'intero sistema.

📎 Related Topics