Guida utente — Configurazione e gestione globale della leva finanziaria

Panoramica

Questa guida spiega come utilizzare le opzioni di configurazione della leva finanziaria in tradesettings.yaml sotto Impostazioni Generali per gestire la leva su tutti i simboli di trading nel tuo exchange.

1. SetLeverageStartup

SetLeverageStartup: false

Scopo: Applica la leva definita a tutti i simboli di trading all'avvio del bot.

Quando abilitare (true)

  • ✅ Prima configurazione: quando devi impostare la leva per tutti i simboli inizialmente
  • ✅ Dopo aver modificato le impostazioni della leva: quando hai cambiato la leva desiderata
  • ✅ Dopo aver aggiunto nuovi simboli: quando vengono aggiunte nuove coppie di trading all'exchange

Quando disabilitare (false)

  • ✅ Dopo un aggiornamento della leva riuscito: per evitare chiamate API inutili
  • ✅ Operatività normale: per evitare di reimpostare la leva ad ogni riavvio
  • ✅ Quando la leva è già configurata: se tutti i simboli hanno la leva corretta

⚠️ Note importanti

  • Imposta sempre su false dopo che la leva è stata aggiornata correttamente per evitare:
    • Chiamate API non necessarie ad ogni inizializzazione
    • Possibili limitazioni di frequenza da parte dell'exchange
    • Tempi di avvio più lenti
# Passaggio 1: Abilita per aggiornare la leva
SetLeverageStartup: true

# Passaggio 2: Avvia il bot (la leva verrà applicata)
# Passaggio 3: Arresta il bot

# Passaggio 4: Disabilita prima del prossimo avvio
SetLeverageStartup: false

Esempio di flusso di lavoro

1. Imposta la leva desiderata nel file di configurazione (es. 10x)
2. Abilita SetLeverageStartup: true
3. Avvia il bot → La leva viene applicata a tutti i simboli
4. Arresta il bot
5. Disabilita SetLeverageStartup: false
6. Riavvia il bot per il trading normale

2. SetMaxLeverage

SetMaxLeverage: false

Scopo: Utilizzare automaticamente la leva massima consentita dall'exchange per ogni simbolo invece del valore configurato manualmente.

Come funziona

Quando è false (predefinito):

  • Utilizza il valore di leva configurato per tutti i simboli
  • Se non supportato, la chiamata API può fallire

Quando è true:

  • Recupera la leva massima supportata per ogni simbolo
  • Utilizza il valore minore tra quello configurato e il massimo dell'exchange

Esempi di scenari

# Scenario 1: Il simbolo supporta la tua leva
Configurazione: 20x
Massimo simbolo: 50x
Risultato: 20x

# Scenario 2: Il simbolo ha un limite massimo inferiore
Configurazione: 20x
Massimo simbolo: 5x
Risultato: 5x
Output bot: "ℹ️ XYZUSDT leva massima è 5x, utilizzo 5x invece di 20x"

# Scenario 3: Il simbolo ha un limite massimo superiore
Configurazione: 10x
Massimo simbolo: 125x
Risultato: 10x

Quando abilitare (true)

  • ✅ Approccio sicuro per evitare errori legati alla leva
  • ✅ Tipi di simboli misti con limiti di leva diversi
  • ✅ Trading conservativo per auto-adattarsi ai limiti
  • ✅ Bot multi-exchange con regole differenti

Quando disabilitare (false)

  • ✅ Leva uniforme supportata su tutti i simboli
  • ✅ La strategia richiede valori di leva esatti
  • ✅ Ottimizzazione delle prestazioni (meno chiamate API)

Integrazione con symbols.json

Flusso di aggiornamento della leva

1. Il bot legge la leva da tradesettings.yaml
2. Se SetMaxLeverage: true → Recupera la leva massima
3. Calcola la leva finale (minimo tra configurata e massima)
4. Applica la leva tramite API dell'exchange
5. ✅ Aggiorna symbols.json con la leva effettivamente applicata
6. Il bot utilizza la leva da symbols.json per il trading

Perché è importante l'aggiornamento di symbols.json

  • Garantisce coerenza con l'exchange
  • Persiste attraverso i riavvii
  • Consente il tracciamento visivo della leva effettivamente utilizzata

⚠️ Importante: tempistica di sincronizzazione

# ❌ ERRATO
SetLeverageStartup: true
SetMaxLeverage: true

# ✅ CORRETTO (Aggiornamento una tantum)
SetLeverageStartup: true
SetMaxLeverage: true
# Dopo il successo:
SetLeverageStartup: false
SetMaxLeverage: false

Flussi di configurazione consigliati

Configurazione iniziale (nuovo bot)

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: true
SetMaxLeverage: true
  1. Configura le impostazioni sopra
  2. Avvia il bot → La leva viene applicata e symbols.json aggiornato
  3. Arresta il bot
  4. Disabilita entrambe le impostazioni
  5. Riavvia per l'operatività normale

Modifica del valore di leva

# tradesettings.yaml
Leverage: 15
SetLeverageStartup: true
SetMaxLeverage: true
  1. Aggiorna il valore della leva
  2. Abilita SetLeverageStartup
  3. Avvia il bot → La nuova leva viene applicata
  4. Arresta il bot
  5. Disabilita di nuovo prima del prossimo avvio

Operatività normale (consigliata)

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: false
SetMaxLeverage: false

Il bot legge la leva da symbols.json (già configurato e aggiornato).

Aggiunta di nuovi simboli

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: true
SetMaxLeverage: true
  1. Aggiungi nuovi simboli all'exchange
  2. Abilita SetLeverageStartup
  3. Avvia il bot → La leva viene applicata a tutti i simboli
  4. Arresta il bot
  5. Disabilita prima del trading normale

Risoluzione dei problemi

  • Problema: Il bot continua a reimpostare la leva
    Causa: SetLeverageStartup: true lasciato attivo
    Soluzione: Imposta su false dopo la configurazione iniziale
  • Problema: La leva non viene applicata
    Causa: SetLeverageStartup: false durante l'aggiornamento
    Soluzione: Abilita temporaneamente e riavvia
  • Problema: Errori API relativi ai limiti di leva
    Causa: La leva configurata supera il massimo consentito
    Soluzione: Abilita SetMaxLeverage: true
  • Problema: Disallineamento di symbols.json
    Causa: Modifica manuale o desincronizzazione
    Soluzione: Abilita SetLeverageStartup: true una volta per risincronizzare

Buone pratiche

✅ DA FARE

  • Imposta SetLeverageStartup: false dopo aggiornamenti riusciti
  • Usa SetMaxLeverage: true per la prima configurazione
  • Verifica i valori di leva in symbols.json
  • Conserva backup prima delle modifiche
  • Testa su un simbolo prima di applicare a tutti

❌ DA NON FARE

  • Lasciare SetLeverageStartup: true durante il funzionamento normale
  • Modificare la leva senza abilitare SetLeverageStartup
  • Modificare manualmente symbols.json
  • Abilitare entrambe le opzioni ripetutamente (causa sovraccarico API)

Tabella di riferimento rapido

Scenario SetLeverageStartup SetMaxLeverage Quando usarlo
Configurazione iniziale true true Prima esecuzione del bot
Trading normale false false Operatività quotidiana
Modifica della leva true true Dopo aver modificato il valore della leva
Aggiunta di nuovi simboli true true Nuove coppie aggiunte all'exchange
Modalità conservativa false true Adattamento automatico ai limiti dell'exchange
Modalità prestazioni false false Minimizza le chiamate API

Supporto

  1. Controlla i log del bot per eventuali errori
  2. Verifica che le autorizzazioni API dell'exchange includano la modifica della leva
  3. Assicurati che tutti i simboli esistano sull'exchange
  4. Controlla symbols.json per la leva corretta
  5. Verifica i limiti di leva specifici dell'exchange

📎 Related Topics