Come Gestire le Chiavi API del Tuo Exchange su Freya Finance
Le tue chiavi API sono ciò che permette a Freya di piazzare trade sul tuo exchange al posto tuo. Una volta collegato un exchange, tutte le tue chiavi risiedono in un unico posto dove puoi rivederle, vedere esattamente cosa è autorizzata a fare ciascuna, aggiungerne altre o rimuovere quelle che non usi più. Questa guida spiega come gestirle.
Se stai collegando un exchange per la prima volta, parti da Come Collegare il Tuo Exchange — questo articolo riguarda la gestione delle chiavi che hai già aggiunto.
Key Takeaways
- Tutte le chiavi API degli exchange che hai collegato risiedono in Impostazioni → Chiavi API, con l'exchange, un'etichetta, la data di aggiunta e lo stato.
- Ogni chiave mostra le sue autorizzazioni — Read, Trade e (per i futures) accesso Futures — così vedi esattamente cosa consente.
- Puoi aggiungere un'altra chiave in qualsiasi momento, oppure eliminarne una che non usi più.
- Freya non elimina una chiave finché un bot la sta usando — ferma o metti in pausa quei bot prima; l'eliminazione non è reversibile e ricevi una notifica ogni volta che una chiave viene rimossa.
- Le tue credenziali API sono archiviate in forma crittografata, e Freya non ha mai bisogno dell'autorizzazione di prelievo sulle tue chiavi.
Una Rapida Panoramica dei Passaggi
- Apri l'elenco delle tue chiavi — vai in Impostazioni → Chiavi API per vedere ogni exchange collegato, ciascuno con la sua etichetta, la data di aggiunta e lo stato.
- Controlla le autorizzazioni di ogni chiave — verifica che mostri Read e Trade (e Futures se fai trading di futures), e mai l'accesso di prelievo.
- Aggiungi una chiave quando ne hai bisogno — usa Aggiungi Chiave API per collegare un altro exchange o una chiave aggiuntiva, seguendo lo stesso flusso della tua prima connessione.
- Elimina le chiavi che non usi più — scegli Elimina e conferma. Se un bot sta ancora usando quella chiave, Freya rifiuta l'eliminazione e ti dice quanti sono; fermali o mettili in pausa prima.
Dove Trovare le Tue Chiavi API
Vai in Impostazioni → Chiavi API. Vedrai Le Tue Chiavi API — un elenco di ogni connessione a un exchange sul tuo account. Per ciascuna, Freya mostra:
- L'exchange (Binance, OKX o Bybit).
- Un'etichetta per la chiave, così puoi distinguerne diverse.
- La data in cui è stata aggiunta.
- Il suo stato (Attivo).
Se non hai ancora collegato nulla, vedrai invece un prompt Aggiungi la Tua Prima Chiave API.
Comprendere le Autorizzazioni delle Chiavi
Ogni chiave mostra le autorizzazioni con cui è stata creata, così non c'è mai alcun dubbio su cosa può fare:
- Read — permette a Freya di vedere i tuoi saldi e le tue posizioni (necessario per tutto).
- Trade — permette a Freya di piazzare e gestire gli ordini (è ciò che i tuoi bot usano per fare trading).
- Futures — presente quando la chiave ha anche l'accesso al trading di futures abilitato.
Questa trasparenza è importante: una chiave Freya serve solo per leggere e fare trading. Non ha — e non dovrebbe avere — l'autorizzazione di prelievo, quindi i tuoi fondi non possono mai lasciare il tuo exchange attraverso Freya. Per il quadro completo, vedi I Miei Soldi Sono al Sicuro su Freya Finance?.
Aggiungere un'Altra Chiave
Puoi collegare più di un exchange (o più di una chiave) dalla stessa schermata usando Aggiungi Chiave API. La configurazione segue lo stesso flusso della tua prima connessione — vedi Come Collegare il Tuo Exchange per la procedura passo dopo passo, inclusa la passphrase di OKX.
Eliminare una Chiave
Per rimuovere una connessione, scegli Elimina sulla chiave e conferma. Alcune cose da sapere:
- È irreversibile. Dovresti aggiungere di nuovo la chiave da zero per ricollegarti.
- Freya controlla prima di eliminare. Se un bot sta operando con quella chiave, o è armato in attesa di operare, l'eliminazione viene rifiutata e ti viene indicato quanti bot sono coinvolti. Fermali o mettili in pausa dalla dashboard e riprova — un bot che perde la chiave a metà operazione non può più gestire la posizione già aperta.
- Ricevi una notifica quando una chiave viene rimossa — un accorgimento di sicurezza così sai sempre quando cambia un accesso.
Le Tue Chiavi Sono Archiviate in Sicurezza
Freya archivia le tue credenziali API in forma crittografata — la schermata Chiavi API le etichetta persino come archiviate in modo sicuro. Combinato con chiavi che non hanno l'autorizzazione di prelievo, questo significa che anche nel caso peggiore, nessuno può spostare fondi fuori dal tuo account exchange attraverso Freya.
Domande Frequenti
Dove gestisco le chiavi API del mio exchange?
In Impostazioni → Chiavi API. Quella schermata elenca ogni chiave collegata con il suo exchange, l'etichetta, la data di aggiunta e lo stato — ed è dove aggiungi nuove chiavi o elimini quelle esistenti.
Cosa significano le etichette Read, Trade e Futures?
Mostrano cosa è autorizzata a fare ciascuna chiave. Read permette a Freya di vedere i tuoi saldi e le tue posizioni; Trade le permette di piazzare e gestire gli ordini (ciò che i tuoi bot usano); e Futures compare quando la chiave ha anche l'accesso al trading di futures. Una chiave Freya non ha mai bisogno dell'autorizzazione di prelievo.
Come aggiungo un altro exchange o un'altra chiave?
Usa Aggiungi Chiave API nella stessa schermata. Esegue lo stesso flusso di connessione della tua prima chiave — vedi la guida Come Collegare il Tuo Exchange per la procedura completa, inclusa la passphrase aggiuntiva di OKX.
Cosa succede quando elimino una chiave API?
Freya controlla prima se qualcosa dipende ancora da essa. Se un bot sta operando con quella chiave, o è in attesa di un segnale, l'eliminazione viene rifiutata e vedrai quanti bot sono coinvolti — fermali o mettili in pausa, poi elimina. Quando nulla dipende più dalla chiave, la connessione viene rimossa e non è reversibile. Riceverai anche una notifica che conferma la rimozione.
Le mie chiavi API sono archiviate in sicurezza?
Sì. Le tue credenziali sono archiviate in forma crittografata, e le chiavi che colleghi hanno solo l'accesso di trading — mai l'autorizzazione di prelievo. Questa combinazione significa che i tuoi fondi non possono essere prelevati dal tuo exchange attraverso Freya.
Freya può prelevare i miei fondi usando la mia chiave API?
No. Le chiavi vengono create solo con accesso di lettura e di trading — non di prelievo. Anche se qualcosa andasse storto, nessuno potrebbe spostare i tuoi fondi fuori dall'exchange usando una chiave Freya.
Come modifico le autorizzazioni di una chiave API, la ruoto o la disattivo?
Non esiste una modifica diretta per una chiave collegata. Per cambiare i permessi, rinnovare o sostituire una chiave, la elimini da Freya e aggiungi quella nuova — crea la chiave aggiornata sul tuo exchange, poi ricollegala. Ferma o metti in pausa prima i bot che usano la vecchia chiave, dato che Freya non rimuove una chiave ancora in uso; una volta collegata la nuova, punta quei bot su di essa e riavviali. Per smettere di usare una chiave senza rimuoverla, metti in pausa i bot che ne dipendono invece di cancellarla.
