Quando un bot non riesce a fare qualcosa, ti mostra un breve messaggio — ma non è sempre ovvio cosa farci. Questa è una guida di consultazione rapida: trova il messaggio che hai visto, capisci cosa significa e scopri se è qualcosa che risolvi tu o qualcosa che l'exchange risolve da solo. Per approfondimenti, ogni gruppo rimanda alla guida di troubleshooting dedicata.
Punti chiave
- La maggior parte degli errori rientra in poche categorie: saldo/margine, chiave API, leva/modalità margine, limiti degli ordini, coppie delistate, piazzamento degli ordini di uscita e problemi temporanei dell'exchange.
- Molti messaggi provengono dall'exchange e non dipendono da te (modalità solo-cancellazione, rate limit, timeout) — Freya li ritenta automaticamente.
- Quelli che risolvi tu riguardano di solito saldo, dimensione dell'ordine, permessi API o impostazioni di leva/margine.
- Se un messaggio dice «controlla la tua posizione manualmente», la tua posizione potrebbe essere non protetta — imposta subito il suo take-profit/stop-loss sull'exchange.
- Errori persistenti o non riconosciuti → contatta [email protected] con i dettagli del bot e del deal.
Saldo e Margine
| Messaggio che vedi | Cosa significa | Cosa fare |
|---|---|---|
| "Saldo insufficiente. Controlla i fondi del tuo conto." | Fondi liberi insufficienti sull'exchange per questo ordine. | Aggiungi fondi sull'exchange o riduci l'importo dell'ordine del bot. |
| "Margine insufficiente. Riduci la dimensione della posizione o aggiungi margine." | Futures: margine insufficiente per la posizione a questa leva. | Aggiungi margine, riduci la dimensione della posizione o modifica la leva. |
| "Valore dell'ordine troppo piccolo. Aumenta l'importo del tuo bot." | Sotto la dimensione minima dell'ordine per la coppia. | Aumenta l'importo del bot sopra il minimo della coppia. |
➡️ Approfondimento: Perché il Mio Bot si è Messo in Pausa o si è Fermato? e Quanto Capitale Serve al Tuo Bot.
Chiave API e Permessi
| Messaggio che vedi | Cosa significa | Cosa fare |
|---|---|---|
| "Errore della chiave API. Verifica che la tua chiave API sia valida e abbia i permessi di trading." | La chiave è non valida, revocata o priva del permesso di trading. | Ricontrolla o ricrea la chiave con il trading abilitato. |
| "La chiave API è limitata a un IP. Aggiungi l'IP del server alla tua whitelist." | La lista di IP consentiti della chiave non include l'IP del server di Freya. | Aggiungi l'IP mostrato nella schermata di connessione alla whitelist della chiave. |
➡️ Approfondimento: Non Riesci a Connettere il Tuo Exchange? Errori della Chiave API.
Leva e Modalità Margine (Futures)
| Messaggio che vedi | Cosa significa | Cosa fare |
|---|---|---|
| "Valore di leva non valido. Controlla le impostazioni del tuo exchange." | La leva non è accettata per questa coppia. | Scegli una leva entro l'intervallo consentito per la coppia. |
| "Il valore della posizione supera il massimo consentito per questa leva. Riduci la leva o la dimensione della posizione." | Il nozionale è troppo grande per il tier di leva scelto. | Riduci la leva o la dimensione della posizione. |
| "Mancata corrispondenza della modalità posizione. Controlla le impostazioni della modalità Hedge/One-Way." | La direzione del bot è in conflitto con la modalità posizione del tuo exchange. | Allinea la modalità Hedge/One-Way dell'exchange con il bot — vedi Hedge Mode vs One-Way. |
| "La modalità multi-asset è in conflitto con il margine isolato. Passa al margine cross o disabilita la modalità multi-asset." | Il margine multi-asset non può combinarsi con il margine isolato. | Passa al margine cross o disattiva la modalità multi-asset sull'exchange. |
➡️ Correlati: Tipo di Margine: Cross vs Isolato · Hedge Mode vs One-Way.
Problemi degli Ordini
| Messaggio che vedi | Cosa significa | Cosa fare |
|---|---|---|
| "Raggiunto il numero massimo di ordini aperti. Chiudi prima alcuni ordini." | Hai raggiunto il limite di ordini aperti dell'exchange. | Annulla alcuni ordini aperti, poi riprova. |
| "Il prezzo dell'ordine si discosta troppo dal prezzo di mercato. Riprova." | Un prezzo limite è fuori dalla banda consentita dall'exchange rispetto al mercato. | Riprova; per un ingresso limite, imposta un prezzo più vicino al mercato. |
| "Ordine reduce-only rifiutato. La posizione potrebbe essere già chiusa." | Un ordine di sola-chiusura è stato rifiutato — di solito non c'è più nulla da chiudere. | Controlla la posizione sull'exchange; probabilmente è già chiusa. |
| "Il mercato è in modalità solo-cancellazione. Al momento non è possibile piazzare nuovi ordini." | L'exchange ha messo il mercato in solo-cancellazione (manutenzione/regolamento). | Aspetta — si risolve quando l'exchange riapre. Non dipende da te. |
| "Ordine non trovato sull'exchange. Potrebbe essere stato eseguito o annullato." | L'ordine di riferimento non esiste più. | Di solito è innocuo — è stato eseguito o annullato. Controlla il deal. |
➡️ Approfondimento (problemi di chiusura): Il Mio Deal Non si Chiude.
Coppia di Trading (Delisting)
| Messaggio che vedi | Cosa significa | Cosa fare |
|---|---|---|
| "Coppia di trading non trovata. Potrebbe essere stata delistata dall'exchange." | La coppia è stata rimossa o rinominata sull'exchange. | Sposta il bot su una coppia attiva e quotata. |
| "Coppia di trading non trovata sull'exchange. Potrebbe essere stata delistata." | L'exchange segnala che lo strumento non esiste. | Scegli una coppia attualmente quotata. |
Questi sono cambiamenti lato exchange, non dipendono da te — se un exchange delista una moneta, nessun bot può continuare a operarla.
Piazzamento degli Ordini di Uscita ("Controlla la Tua Posizione Manualmente")
| Messaggio che vedi | Cosa significa | Cosa fare |
|---|---|---|
| "Piazzamento dell'ordine di take profit/stop loss non riuscito. Controlla la tua posizione manualmente." | Il tuo ingresso è stato eseguito ma la protezione di uscita non ha potuto essere piazzata — la tua posizione potrebbe essere non protetta. | Imposta tu stesso il take-profit/stop-loss sull'exchange ora, poi controlla il bot. |
| "Aggiornamento di TP/SL non riuscito dopo l'esecuzione di una Safety Order. Controlla la tua posizione manualmente." | Dopo l'esecuzione di una Safety Order, l'uscita non ha potuto essere aggiornata alla nuova media. | Verifica che i tuoi livelli di uscita riflettano il nuovo Entry medio. |
| "Il tuo ordine di uscita (TP/SL) è stato annullato al di fuori di Freya Finance. La tua posizione non è più protetta." | Un ordine di uscita è stato annullato sull'exchange, al di fuori di Freya. | Riproteggi la posizione (imposta TP/SL) o chiudila. |
Qualsiasi messaggio «controlla la tua posizione manualmente» significa che una posizione potrebbe essere in esecuzione senza la sua protezione di uscita. Apri il tuo exchange, conferma la posizione e imposta tu stesso il suo stop-loss / take-profit finché il bot non può riprendere il controllo.
Problemi Temporanei (Freya li Ritenta)
| Messaggio che vedi | Cosa significa | Cosa fare |
|---|---|---|
| "Rate limit dell'exchange raggiunto. Verrà ritentato automaticamente." | Troppe richieste; limitato per un breve periodo. | Niente — Freya ritenta da solo. |
| "Connessione all'exchange scaduta. Riprova." | Una richiesta non si è completata in tempo. | Aspetta un momento; di solito si risolve. |
| "Errore di connessione di rete. Riprova." | Un guasto a livello di rete nel raggiungere l'exchange. | Riprova tra poco. |
| "Errore di sincronizzazione dell'ora del server. Di solito si risolve automaticamente." | Uno scostamento di orologio/timestamp rispetto all'exchange. | Di solito si auto-corregge; nessuna azione. |
| "Il server dell'exchange è occupato. Riprova tra un momento." | L'exchange ha restituito una risposta occupato/non disponibile. | Aspetta e riprova. Non dipende da te. |
Ancora Bloccato?
Se vedi "Si è verificato un errore inatteso dell'exchange. Controlla la tua posizione manualmente." o "Errore interno del sistema. Riprova o contatta il supporto." — verifica la tua posizione sull'exchange e, se persiste, contatta [email protected] con i dettagli del bot e del deal. Per la liquidazione nello specifico, vedi Comprendere la Liquidazione.
Domande Frequenti
Il mio bot ha mostrato un errore — è colpa della piattaforma?
Dipende dal messaggio. Gli errori di saldo, dimensione dell'ordine, chiave API e leva/margine sono di solito impostazioni che risolvi tu. Modalità solo-cancellazione, rate limit, timeout, coppie delistate e "server occupato" sono lato exchange e non dipendono da te — Freya ritenta automaticamente quelli temporanei.
Cosa significa "controlla la tua posizione manualmente"?
Significa che il tuo ingresso è stato eseguito ma Freya non ha potuto piazzare o aggiornare la protezione di uscita, quindi la posizione potrebbe essere in esecuzione senza uno stop-loss o un take-profit. Apri il tuo exchange, conferma la posizione e imposta tu stesso i suoi livelli di uscita subito — poi controlla il bot.
Ho ricevuto "saldo insufficiente" ma ho i fondi — perché?
I tuoi fondi potrebbero non essere liberi (già impegnati in altri ordini/posizioni), nel sub-account sbagliato o al di sotto di ciò che serve all'ordine una volta incluse le commissioni. Libera saldo o riduci l'importo dell'ordine del bot. Vedi Perché il Mio Bot si è Messo in Pausa o si è Fermato?
La mia coppia dice che è stata delistata — e adesso?
L'exchange ha rimosso o rinominato quella coppia di trading, quindi nessun bot può più operarla. Sposta il bot su una coppia attualmente quotata. Questo è un cambiamento dell'exchange, non un problema di Freya.
L'errore dice "rate limit / timeout / server occupato" — devo fare qualcosa?
No. Sono condizioni temporanee lato exchange, e Freya ritenta automaticamente. Se un bot resta bloccato a lungo dopo che l'exchange si è ripreso, controlla il suo stato e contatta il supporto se necessario.
Dove trovo aiuto dettagliato per gli errori della chiave API o di chiusura?
Per gli errori di chiave API / IP / permessi, vedi Non Riesci a Connettere il Tuo Exchange? Per posizioni che non si chiudono o ordini residui, vedi Il Mio Deal Non si Chiude. Per il motivo per cui un bot si è fermato, vedi Perché il Mio Bot si è Messo in Pausa o si è Fermato?