Collega Bybit a Freya
Bybit è l'unico exchange dove Freya può configurare la connessione per te. Freya è un broker registrato di Bybit, il che significa che Bybit crea la chiave API dal proprio lato, le assegna i permessi giusti e la consegna direttamente a Freya — non vedi mai una chiave, non copi mai un secret e non metti mai un indirizzo IP in whitelist.
Questa strada si chiama Connessione rapida. La strada più vecchia, in cui crei la chiave da solo su Bybit, esiste ancora e funziona ancora. Questa guida copre entrambe, più cosa fare quando devi sostituire una chiave o quando una connessione fallisce.
Key Takeaways
- La Connessione rapida è un clic: approvi Freya su Bybit, e le tue chiavi Spot e Futures vengono aggiunte automaticamente.
- La Connessione rapida non richiede whitelist degli IP — è Bybit stessa a vincolare la chiave ai server di Freya, ed è anche il motivo per cui non scade.
- La Connessione manuale funziona ancora ed è l'unica strada su Binance e OKX.
- Qualunque strada tu scelga, la chiave non riceve mai il permesso di prelievo. Freya non può spostare i tuoi fondi.
- Collegarsi una seconda volta non crea duplicati — Bybit emette una chiave per piattaforma per account, quindi aggiorna quella che hai già.
Prima di Iniziare
Vale la pena controllare due cose per prime.
Metti fondi sull'account che stai collegando. Un bot non può aprire una posizione su un saldo vuoto, e Freya collegherà tranquillamente una chiave che non ha nulla con cui operare. Se prevedi di eseguire bot futures, assicurati che i fondi siano sull'account che i tuoi bot useranno.
Usa un browser. Entrambe le strade funzionano su browser desktop e mobile. Creare una chiave API a mano è un'operazione possibile solo da browser sul lato di Bybit — la loro app mobile non espone la schermata delle chiavi API.
Connessione rapida
Questa è la strada che consigliamo. Richiede circa quindici secondi se hai già effettuato l'accesso a Bybit.
- In Freya, apri Impostazioni → Chiavi API e seleziona Aggiungi Chiave API.
- Scegli Bybit come exchange. La scheda Connessione rapida è già selezionata.
- Seleziona Collega con Bybit. Si apre una scheda di Bybit.
- Accedi a Bybit. Se non hai ancora un account, puoi crearne uno lì e tornare — la connessione ti aspetta.
- Controlla e approva. Bybit ti mostra esattamente cosa sta chiedendo Freya. Approvare è l'unico passaggio che concede qualcosa.
- La scheda si chiude da sola e le tue chiavi appaiono in Freya, pronte all'uso.
Una sola approvazione copre sia Spot che Futures. Non devi ripeterla per ogni mercato.
Cosa Succede Dietro le Quinte
Quando approvi, Bybit crea una chiave API legata alla registrazione broker di Freya e la invia direttamente ai server di Freya. Poiché arriva in questo modo, non passa mai dal tuo browser, dai tuoi appunti o da uno screenshot — che è il modo in cui le chiavi API trapelano più spesso.
Bybit inoltre vincola da sé quella chiave ai server di Freya. Due conseguenze di cui benefici:
- Nessuna whitelist degli IP. Non c'è nulla da copiare o incollare nelle impostazioni di Bybit.
- La chiave non scade. Una chiave creata a mano può scadere; una vincolata tramite broker no.
Se Cambi Idea
Rifiutare sulla schermata di Bybit è del tutto sicuro. Non viene creato nulla su Bybit e non cambia nulla in Freya — vedrai semplicemente che l'autorizzazione non è stata completata, e potrai riprovare quando vuoi.
Chiudere la scheda di Bybit senza decidere ha lo stesso effetto.
Sostituire una Chiave Bybit
A volte serve una chiave nuova — hai revocato quella vecchia su Bybit, stai passando a un altro account Bybit, oppure il supporto ti ha chiesto di ricollegarti.
Con la Connessione rapida, basta collegarsi di nuovo. Apri Impostazioni → Chiavi API → Aggiungi Chiave API, scegli Bybit e seleziona Collega con Bybit come prima. Bybit emette una chiave per piattaforma per account, quindi ricollegarsi aggiorna quella che hai già invece di accumulare una seconda copia. I tuoi bot esistenti continuano a girare sulla credenziale aggiornata.
Se hai prima eliminato la chiave dal lato di Bybit, ricollegarsi è comunque la soluzione — Bybit ne emetterà una nuova all'approvazione.
⚠️ Non eliminare la tua chiave in Freya mentre i bot sono in esecuzione, a meno che tu non intenda fermarli. Un bot in esecuzione senza una credenziale funzionante non può gestire la posizione che ha già aperto. Ferma o chiudi prima i tuoi bot, poi ricollegati.
Connessione manuale
Usala se preferisci creare la chiave da solo, o se stai collegando un sub-account Bybit.
Crea la Chiave su Bybit
- Accedi a Bybit da un browser e apri la sezione API del tuo account.
- Crea una chiave API generata dal sistema (System-generated).
- Scegli API Transaction come tipo di utilizzo — non la sola lettura.
- Concedi i permessi Contract Trade e Spot Trade, oltre all'accesso in lettura.
- Non concedere mai il prelievo (Withdrawal). Freya non ne ha bisogno e non può usarlo.
- Limita la chiave per IP e inserisci l'indirizzo di Freya, che la finestra ti mostra e ti lascia copiare.
⚠️ Bybit mostra il tuo secret esattamente una volta. Copialo prima di chiudere quella schermata. Se lo perdi, la chiave non può essere recuperata — devi crearne una nuova.
Aggiungi la Chiave a Freya
- In Freya, apri Impostazioni → Chiavi API → Aggiungi Chiave API e scegli Bybit.
- Passa alla scheda Connessione manuale.
- Incolla la chiave API e il secret, e dai alla chiave un nome che riconoscerai in seguito.
- Seleziona Aggiungi Chiave API. Freya convalida immediatamente la connessione e i permessi.
Se la convalida fallisce, Freya ti dice esattamente quale parte è fallita invece di un errore generico. Vedi Risolvere gli errori di connessione della chiave API dell'exchange per ogni messaggio e la relativa soluzione.
Domande Frequenti
Quale strada dovrei usare?
La Connessione rapida, a meno che tu non abbia un motivo specifico per non farlo. Ha meno passaggi, non può fallire per un errore di battitura, ed elimina del tutto la whitelist degli IP. La Connessione manuale esiste per chi vuole creare e controllare la chiave da solo, e per i sub-account.
La Connessione rapida dà a Freya più accesso di una chiave manuale?
No. Entrambe le strade producono una chiave di trading con lo stesso ambito: lettura e trading, mai il prelievo. La differenza sta in chi fa la configurazione, non in cosa può fare la chiave.
Devo mettere un indirizzo IP in whitelist?
Solo con la Connessione manuale. Con la Connessione rapida è Bybit a vincolare automaticamente la chiave ai server di Freya, ed è anche il motivo per cui quella chiave non scade.
Posso collegare Spot e Futures di Bybit separatamente?
Con la Connessione rapida non devi — una sola approvazione configura entrambi. Con la Connessione manuale puoi aggiungere chiavi separate se preferisci tenere i mercati distinti.
Cosa succede se mi collego due volte?
Non si rompe nulla e non si duplica nulla. Bybit emette una chiave per piattaforma per account, quindi una seconda connessione aggiorna quella esistente.
Posso usare la Connessione rapida con un sub-account Bybit?
Per i sub-account usa la Connessione manuale. La Connessione rapida è pensata per il tuo account Bybit principale.
La mia chiave è al sicuro una volta in Freya?
Viene crittografata nel momento in cui arriva e non viene mai più mostrata — né a te, né al supporto. Eliminarla in Freya rimuove la credenziale memorizzata, e revocarla su Bybit taglia l'accesso dall'altro lato. Per il quadro completo vedi I miei soldi sono al sicuro su Freya Finance?.
Freya dice che la mia chiave non è valida subito dopo il collegamento. Perché?
Il più delle volte la chiave è stata creata senza il permesso di trading, oppure è stata limitata a un IP che non è quello di Freya. Con la Connessione rapida non può accadere né l'una né l'altra cosa, quindi ricollegarsi tramite quella strada è di solito la soluzione più rapida.