Perché il Mio Bot si è Messo in Pausa o si è Fermato?

#Perché il Mio Bot si è Messo in Pausa o si è Fermato?

Quando un bot smette di fare quello che ti aspetti, la causa è quasi sempre una tra una manciata di problemi risolvibili — di solito qualcosa lato exchange, come i fondi o i permessi della chiave API. Questa guida esamina ciascun caso, dal più al meno comune.

Non è la stessa cosa di un bot che non apre operazioni. Se il tuo bot funziona regolarmente ma non è entrato in una posizione, di solito è una questione di condizioni di ingresso — vedi Perché il Mio Bot Non Opera?. Questo articolo riguarda un bot che si è messo in pausa, fermato o ha generato un errore.

---

#Gli Stati del Bot in Sintesi

• Attivo — attivo e in osservazione del mercato per le sue condizioni di ingresso; nessuna posizione ancora aperta.
• Attivazione — le condizioni di ingresso sono state soddisfatte; il bot sta aprendo la sua posizione.
• In esecuzione — una posizione è aperta e il bot sta gestendo l'operazione (safety order, take-profit, uscite).
• In pausa — l'hai messo in pausa; non aprirà nuove posizioni finché non lo riprendi.
• In attesa di pausa — l'hai messo in pausa mentre una posizione era aperta; termina la gestione di quella posizione in sicurezza, poi passa a In pausa.
• Errore — ha provato ad agire ma l'exchange o un controllo lo ha rifiutato; si ferma e segnala il problema.
• In chiusura / Chiuso — il bot sta terminando l'operazione; una volta conclusa, l'operazione viene salvata nella tua cronologia.

(Per il riferimento completo agli stati con la distinzione tra ATTIVO e IN ESECUZIONE, vedi Perché il Mio Bot Non Opera?.)

Quando un bot incontra un problema da cui non può recuperare, passa a uno stato di errore e ricevi una notifica di «bot in errore» (se hai configurato le notifiche), così puoi risolverlo rapidamente.

#La Causa Più Comune: Saldo o Margine Insufficiente

Di gran lunga il motivo più frequente per cui un bot smette di piazzare ordini è un saldo insufficiente (spot) o un margine insufficiente (futures) sul tuo conto exchange. Il tuo bot ha provato a piazzare un ordine — un base order, un averaging order o un take-profit — e l'exchange ha rifiutato perché i fondi non c'erano.

Soluzione: assicurati che il tuo conto exchange abbia abbastanza saldo/margine libero per coprire l'intero piano del bot — inclusi tutti gli averaging order nella sua griglia. (Ecco perché finanziare l'intera griglia è importante; vedi Ordini di Ingresso e la Griglia.)

#Problemi con la Chiave API

Se Freya non può più agire per tuo conto, il bot si ferma. Cause comuni legate alla chiave API:

• Chiave non valida, revocata o rigenerata — se hai eliminato o ruotato la chiave sull'exchange, la copia di Freya non funziona più.
• Permessi sbagliati — la chiave necessita dei permessi di lettura e trading (mai di prelievo). Una chiave di sola lettura non può piazzare ordini.
• Blocco della whitelist IP — se hai limitato la chiave a IP specifici, gli IP dei server di Freya devono essere autorizzati (vengono mostrati quando colleghi l'exchange).

Soluzione: ricollega con una nuova chiave con permessi di lettura e trading. Vedi Come Collegare il Tuo Exchange e Gestione delle Tue Chiavi API.

#Ordine Troppo Piccolo

Ogni exchange ha una dimensione minima dell'ordine (un valore nozionale minimo). Se l'importo del tuo ordine — o un singolo ordine della griglia — scende sotto quel valore, l'exchange rifiuta l'ordine.

Soluzione: aumenta il tuo importo di trading (o il volume per ordine) in modo che ogni ordine superi il minimo dell'exchange.

#Specifico per i Futures: Leva e Modalità di Posizione

Sui futures, due impostazioni possono bloccare gli ordini:

• Leva troppo alta — la leva che hai impostato supera quella consentita dall'exchange per quella coppia. Abbassala a un livello ammesso.
• Discordanza della modalità di posizione — il tuo conto exchange è in una modalità di posizione diversa (hedge o one-way) rispetto a quella che il bot si aspetta. Allinea la modalità di posizione sull'exchange al modo in cui il bot opera.

#Problemi Temporanei dell'Exchange

Alcuni errori non dipendono da te e spesso si risolvono da soli:

• Rate limit — troppe richieste in un breve intervallo di tempo.
• Timeout / errori di rete — un problema momentaneo di connessione con l'exchange.
• Errori di timestamp — un problema di sincronizzazione dell'orologio tra i sistemi e l'exchange.
• Exchange occupato / in manutenzione — l'exchange stesso è sovraccarico o non disponibile.

Soluzione: questi di solito si risolvono da soli. Se un bot è andato in errore per uno di questi motivi, in genere puoi riprenderlo una volta che l'exchange torna a rispondere normalmente.

#Cosa Fare: Una Checklist Rapida

1. Controlla il saldo/margine sul tuo exchange — la causa numero uno. Ricaricalo se è basso.
2. Controlla la tua chiave API — ancora valida, con permessi di lettura e trading, IP di Freya autorizzati.
3. Controlla la dimensione dell'ordine — sopra il minimo dell'exchange.
4. Sui futures, verifica che la leva sia entro i limiti e che la modalità di posizione corrisponda.
5. Se era un errore temporaneo, attendi che l'exchange si riprenda e riprendi il bot.
6. Ancora bloccato? Contatta [email protected].

#Domande Frequenti

#Perché il mio bot si è messo in pausa o si è fermato?

Il più delle volte perché l'exchange ha rifiutato un ordine — di solito un saldo o un margine insufficiente, un problema con la chiave API o un ordine sotto la dimensione minima dell'exchange. Sui futures, anche le impostazioni di leva o modalità di posizione possono bloccare gli ordini. Anche i problemi temporanei dell'exchange (rate limit, timeout) possono fermare un bot, ma quelli in genere si risolvono da soli.

#Cosa significa quando il mio bot è in stato di errore?

Ha provato ad agire ma qualcosa ha rifiutato l'azione, quindi si è fermato e ha segnalato il problema invece di continuare alla cieca. Riceverai una notifica di «bot in errore» (se le notifiche sono attive). Risolvi la causa di fondo — di solito il saldo o la chiave API — e potrai rimetterlo in funzione.

#Il mio bot dice saldo insufficiente — cosa faccio?

Aggiungi fondi al tuo conto exchange in modo che ci sia abbastanza saldo libero (spot) o margine (futures) per coprire gli ordini del bot, inclusa la sua griglia di averaging order. Il bot non ha potuto piazzare un ordine perché i fondi non erano disponibili sull'exchange.

#Potrebbe essere la mia chiave API il problema?

Sì — è un problema comune. Se la chiave è stata eliminata, rigenerata o impostata come sola lettura, oppure se è limitata a IP specifici e gli IP dei server di Freya non sono autorizzati, il bot non può operare. Ricollega con una nuova chiave che abbia i permessi di lettura e trading (mai di prelievo).

#Il mio bot futures non piazza ordini — potrebbe essere la leva o la modalità di posizione?

Sì. Se la tua leva è più alta di quella consentita dall'exchange per quella coppia, o se la modalità di posizione del tuo conto (hedge o one-way) non corrisponde al modo in cui il bot opera, gli ordini vengono rifiutati. Abbassa la leva a un livello ammesso e allinea la modalità di posizione sull'exchange.

#Verrò avvisato se il mio bot va in errore?

Sì — se hai configurato le notifiche, Freya invia un avviso di «bot in errore» quando un bot entra in uno stato di errore, così puoi intervenire rapidamente. Vedi Come Configurare le Notifiche.

#Il mio bot è in esecuzione ma non ha aperto alcuna operazione — è la stessa cosa?

No. Un bot in esecuzione che non è entrato in una posizione di solito non ha ancora soddisfatto le sue condizioni di ingresso — questo è trattato in Perché il Mio Bot Non Opera?. Questo articolo riguarda un bot che si è messo in pausa, fermato o è andato in errore.