Per creare una chiave API Binance per un bot di trading futures, apri prima il tuo conto Binance Futures, poi vai in API Management, crea una chiave System-generated, spunta Enable Futures, lascia disattivato Enable Withdrawals e limita la chiave all'IP del server del bot. Copia subito la secret key, e incolla chiave e secret solo sul sito del bot, mai in una chat.
Qui sotto trovi ogni passaggio come lo descrive oggi l'assistenza di Binance, poi dove va la chiave per HafizeBot e cosa fare se Binance la rifiuta. Binance rinomina i menu ogni tanto: se un'etichetta è diversa, cerca la voce più simile.
Cos'è una chiave API Binance, e cosa non è
Una chiave API è una coppia di stringhe che permette a un programma di agire sul tuo conto Binance senza la tua password. La API key indica quale chiave chiama; la secret key firma ogni richiesta, così Binance sa che arriva davvero da te. Insieme fanno da login per un software, limitato ai permessi che spunti.
Non è la tua password e non sposta i tuoi fondi: il denaro resta nei tuoi wallet Binance, e la chiave consente solo ciò che attivi. Per questo permessi e restrizione IP sono la parte che conta di più.
Creare una chiave non costa nulla. Un bot ti costa le commissioni di trading sugli ordini che piazza, più il prezzo del suo piano.
Prima di iniziare: cosa chiede Binance
L'articolo di Binance sulla creazione delle chiavi API elenca tre cose da fare prima che il pulsante Create API funzioni per te:
- Autenticazione a due fattori (2FA) attivata sul conto.
- Verifica dell'identità completata.
- Un deposito di qualsiasi importo nel tuo Spot Wallet, che secondo Binance attiva il conto.
Per un bot futures c'è un quarto passaggio, e l'ordine conta. Binance afferma che una chiave non può ottenere il permesso Futures se è stata creata prima che tu attivassi il conto Futures. Quindi apri prima i Futures e crea la chiave dopo. Se l'hai già creata prima, eliminala e creane una nuova.
Binance precisa anche che il permesso Futures non si può attivare mentre sul conto è attivo il Portfolio Margin. Se lo usi, sistema questo punto su Binance prima di cominciare.
Come aprire un conto Binance Futures
L'articolo di assistenza di Binance «How to Open a Binance Futures Account?» lo descrive così:
- Scegli Futures dal menu della homepage di Binance ed effettua l'accesso.
- Clicca su Open Account.
- Nella finestra pop-up, seleziona il tuo livello di esperienza nel trading. In base a questo Binance imposta una leva predefinita (il suo articolo indica 2x per i principianti, 5x per gli esperti e 20x per gli avanzati).
- Accetta il Binance Futures Service Agreement & Risk Acknowledgment, poi clicca su Open Now.
Binance aggiunge che devi completare la verifica dell'identità prima di poter fare trading su Binance Futures, e che il conto va finanziato prima della prima operazione. Del finanziamento parliamo più avanti.
Come creare la chiave API sul sito di Binance
Con i Futures aperti, la chiave richiede un paio di minuti. Sul sito, i passaggi di Binance sono:
- Clicca sull'icona del profilo e apri Account.
- Apri API Management e clicca su Create API.
- Scegli il tipo di chiave: System-generated per un bot come il nostro (più sotto i dettagli sui due tipi).
- Inserisci un'etichetta. Dalle il nome del bot, per esempio «HafizeBot», così saprai sempre quale chiave appartiene a quale servizio.
- Conferma con i tuoi dispositivi 2FA o con la passkey.
La chiave viene creata e Binance ti mostra la API key e la secret key. Copia subito la secret in un password manager o direttamente nella pagina delle chiavi del bot. Dai per scontato che non la rivedrai più: se la perdi, la soluzione è eliminare la chiave e crearne una nuova, non recuperarla.
System-generated o self-generated? Una chiave system-generated (HMAC) è creata interamente da Binance. Una chiave self-generated (Ed25519 o RSA) è una coppia che generi tu, dando a Binance solo la metà pubblica; usala solo se un bot la chiede espressamente. La pagina delle chiavi di HafizeBot chiede una chiave system-generated e la relativa secret.
Dove si trova la chiave API nell'app Binance?
Nell'app, secondo Binance, passa alla versione Binance Pro, tocca More per aprire il pannello dei servizi, scorri fino alla sezione Other e tocca API Management. Da lì, Create API, il tipo di chiave, l'etichetta e la verifica 2FA funzionano come sul sito.
Se il menu è stato spostato, digita «API Management» nella barra di ricerca dell'app.
Quali permessi spuntare: solo Reading e Futures
Una nuova chiave parte con Enable Reading, che permette al bot di vedere saldi e posizioni. A un bot futures serve esattamente un'altra casella: Enable Futures. Nient'altro.
- Enable Withdrawals: mai. Nessun bot di trading ne ha bisogno. HafizeBot non lo chiede mai, e se salvi una chiave che lo ha attivo, sia la pagina delle chiavi sia il bot ti avvisano di disattivarlo. Una chiave che non può prelevare non può mandare il tuo denaro da nessuna parte, nemmeno se finisce nelle mani sbagliate.
- Enable Spot & Margin Trading: non serve. Il nostro bot opera solo sui futures USDⓈ-M, quindi il permesso di trading spot aggiunge rischio senza alcuna funzione.
- Altri permessi: lasciali disattivati. Se non sai a cosa servirebbe una casella a un bot, non gli serve.
Per modificare i permessi in seguito, cambia le restrizioni della chiave in API Management e salva.
Limita la chiave a un solo indirizzo IP
Nelle impostazioni di accesso IP della chiave, scegli Restrict access to trusted IPs only e aggiungi l'indirizzo IP da cui opera il tuo bot. Una chiave limitata funziona solo da quel server, quindi una chiave trapelata da uno screenshot, una pagina di phishing o un portatile infetto è inutile a chi la trova.
Per una chiave futures system-generated, in pratica, non è un'opzione. L'articolo di Binance dice che dal 30 gennaio 2023 una chiave system-generated con IP non limitato può avere solo Enable Reading, e che le chiavi HMAC senza restrizioni non hanno altri permessi oltre alla lettura. Le alternative indicate sono una chiave self-generated o disattivare i controlli di sicurezza predefiniti di Binance; la seconda, per una chiave di trading, non la sceglieremmo.
L'IP di HafizeBot è 91.99.78.29. È il server da cui parte ogni chiamata del nostro bot verso Binance, ed è pubblicato nella nostra pagina di aiuto passo per passo per collegare una chiave e nella pagina delle chiavi stessa. Aggiungi esattamente quell'indirizzo, nient'altro. Una chiave limitata a un altro IP, o con un refuso, viene rifiutata da Binance a ogni richiesta.
Imposta la modalità one-way e finanzia il wallet USDⓈ-M Futures
Due impostazioni di Binance fuori dalla chiave decidono se il primo ordine passa.
Modalità di posizione. HafizeBot opera nella modalità one-way di Binance: una posizione per moneta, long o short. In modalità hedge Binance rifiuta gli ordini del bot con l'errore -4061. Per cambiarla, apri la schermata di trading dei futures USDⓈ-M, tocca l'icona delle impostazioni in alto a destra, poi Preference → Position Mode → One-way. Binance lo consente solo senza ordini né posizioni aperte. La nostra pagina di aiuto sulla modalità one-way entra nei dettagli, compreso l'uso di un sub-account se operi a mano in modalità hedge.
Il wallet futures. I saldi Spot, Funding ed Earn non contano per i futures. Nella schermata dei futures, trova il pannello Assets, clicca su Transfer e sposta USDT nel wallet USDⓈ-M Futures. Binance fa notare che i futures USDⓈ-M e COIN-M usano wallet separati, quindi controlla verso quale stai trasferendo.
Quanto trasferire dipende dalle tue impostazioni. Ogni operazione usa come margine la dimensione della tua posizione:
Con i 5 USDT di margine per operazione predefiniti e il limite predefinito di 3 posizioni, a pieno carico impegni 15 USDT, e ogni nuovo ingresso su una moneta che detieni già ne aggiunge altri 5. Quando il wallet non basta, Binance rifiuta l'ordine successivo con «Margin is insufficient», l'errore -2019. Il rapporto tra margine e leva è spiegato in come funziona il trading con leva nelle criptovalute.
Dove inserire la chiave per HafizeBot
Le chiavi per HafizeBot vanno in un solo posto: hafizebot.com/app/keys, dopo l'accesso con Telegram. Non chiediamo mai una chiave o una secret in una chat Telegram, via email o tramite un modulo, e chi lo fa non siamo noi. Le versioni precedenti di questa pagina descrivevano un modulo; quella procedura non esiste più.
La configurazione completa richiede dieci passaggi:
- Su Binance: attiva la 2FA, verifica la tua identità e fai un piccolo deposito sullo Spot.
- Su Binance: apri il conto Futures.
- Su Binance: sposta USDT nel wallet USDⓈ-M Futures.
- Su Binance: imposta la modalità di posizione su one-way.
- Su Binance: crea una chiave system-generated con l'etichetta del bot.
- Su Binance: spunta Enable Futures e lascia disattivato Enable Withdrawals.
- Su Binance: limita la chiave a 91.99.78.29.
- Su Telegram: invia
/autotradea @hafizebot. Per un membro VIP attivo si attiva immediatamente. - Sul sito: apri hafizebot.com/app/login, tocca Log in with Telegram, vai alla pagina delle chiavi e incolla la chiave e la secret.
- Su Telegram: controlla i tuoi limiti con
/settingso/summary, poi invia/on.
Quando salvi, la secret viene cifrata prima di essere memorizzata e non è più visibile; la pagina conferma soltanto che una chiave è impostata e ne mostra gli ultimi quattro caratteri. Salvare una chiave non avvia il trading da solo. Per quello c'è /on.
Se la chiave salvata può prelevare, è aperta a qualsiasi IP o non ha Enable Futures, la pagina delle chiavi la salva comunque e ti dice quale dei tre punti correggere su Binance.
Cosa controlla /on prima che il bot operi
Quando invii /on, il bot interroga Binance una volta sulla chiave salvata prima di attivare il trading automatico:
- La chiave funziona? Se Binance la rifiuta (per esempio con l'errore -2015), il trading automatico resta disattivato e il bot ti comunica il codice e la causa più frequente.
- Enable Futures è spuntato? Se la chiave può leggere il conto ma non operare sui futures, il trading automatico resta disattivato, perché ogni ordine verrebbe comunque rifiutato.
- C'è qualcosa da segnalare? Una chiave che può prelevare o è aperta a qualsiasi IP riceve un avviso nella risposta.
Se Binance in quel momento non risponde, il bot si attiva e avvisa che la chiave non è stata verificata, così un intoppo dell'exchange non blocca nessuno. Se non c'è ancora nessuna chiave salvata, /on ti dice che non si può operare finché non ne aggiungi una.
/on non controlla la modalità di posizione né il saldo futures. Questi emergono al primo ordine, e /lastsignals indica poi il motivo per ogni segnale preso o saltato. Tutti i comandi sono nell'elenco completo dei comandi di HafizeBot.
Come modificare, ruotare o revocare la chiave
- Per revocarla su Binance: apri API Management ed elimina la chiave. Da quel momento Binance la rifiuta e nulla può più operare con essa. Non serve il permesso di nessuno.
- Per rimuoverla da HafizeBot: nella pagina delle chiavi scegli Delete key e conferma. Prima viene disattivato il trading automatico, poi chiave e secret vengono cancellate. Le posizioni e gli ordini già aperti su Binance restano aperti: gestiscili direttamente lì.
- Per ruotarla: crea una nuova chiave allo stesso modo, salvala nella pagina delle chiavi (sostituisce la precedente), poi elimina la vecchia chiave su Binance.
- Se hai incollato per errore una chiave in una chat, o se qualcosa sul conto non ti convince, elimina la chiave su Binance e creane una nuova. Non aspettare di scoprire se ha avuto conseguenze.
Una chiave per ogni bot significa poter tagliare fuori un servizio senza toccare gli altri. Cosa potrebbe fare un bot malevolo con ciascun livello di permesso lo trovi nella nostra guida per collegare in sicurezza un bot di trading a Binance.
Errori comuni dopo aver creato una chiave
Quasi tutti i problemi della prima ora sono una casella dimenticata o un carattere sbagliato, e il codice di errore di Binance dice quale:
Il più frequente è -2015, «Invalid API-key, IP, or permissions for action»: di solito Enable Futures non è spuntato, la restrizione IP non corrisponde esattamente all'IP del bot, oppure la chiave è stata creata prima del conto Futures. I codici -2014 e -1022 indicano di solito che la chiave o la secret sono state incollate con un carattere in meno o in più.
Quando Binance rifiuta una chiave o respinge un ordine per margine insufficiente, HafizeBot disattiva il trading automatico e ti spiega il motivo, invece di ripetere lo stesso errore. Una volta risolto, invia /on.
Cosa non ti dice una chiave funzionante
Una chiave creata correttamente è la parte sicura. Non dice nulla sulla qualità dei segnali di un bot. Per HafizeBot, il risultato di ogni segnale è sulla pagina delle performance in tempo reale, mancati compresi, e i segnali da forza 3 in su compaiono 20 minuti dopo sul canale Telegram gratuito, così puoi osservarli prima di pagare o collegare una chiave. I segnali sono generati dall'IA da un modello che valuta 240+ indicatori, formule e componenti.
Il trading automatico è incluso in ogni piano VIP, che parte da 50 USDT al mese per il Tier 1, pagato in USDT con /join nel bot.
Domande frequenti
Una chiave API Binance è gratuita? Sì. Binance non fa pagare la creazione di una chiave in API Management. Paghi le normali commissioni di trading di Binance sugli ordini piazzati con la chiave, più quanto chiede il servizio del bot.
Come ottengo una chiave API per Binance Futures? Non esiste una chiave futures separata. Apri prima il conto Futures, poi crea una normale chiave in API Management e spunta Enable Futures. Una chiave creata prima dell'apertura del conto Futures non può ottenere quel permesso, quindi creane una nuova.
Perché sulla mia nuova chiave posso spuntare solo Enable Reading? Perché la chiave non è limitata per IP. Binance dice che dal 30 gennaio 2023 una chiave system-generated con IP non limitato può avere solo Enable Reading. Aggiungi l'IP del bot in Restrict access to trusted IPs only e le altre caselle diventano disponibili.
Devo attivare i prelievi per un bot di trading? No. Un bot di trading piazza ordini; non ha mai bisogno di spostare denaro fuori dal tuo conto. Lascia disattivato Enable Withdrawals, così una chiave trapelata non può mandare i tuoi fondi da nessuna parte.
Dove incollo la mia chiave API Binance per HafizeBot? Solo su hafizebot.com/app/keys, dopo aver effettuato l'accesso con Telegram. Mai in una chat Telegram né via email: non chiediamo mai una chiave o una secret in quel modo.
Cosa succede se elimino la chiave API su Binance? Da quel momento Binance la rifiuta, quindi il bot non può più piazzare né modificare ordini. Le posizioni già aperte restano aperte sul tuo conto, con gli ordini di take-profit e di stop che Binance ha già in carico.
In breve
Apri i Futures, poi crea una chiave system-generated per ogni bot con solo Reading e Futures, limitala all'IP del bot e incollala solo sul sito del bot. Tieni Enable Withdrawals disattivato per sempre. Una buona chiave rende un bot sicuro da collegare, non redditizio da usare: il trading di futures con leva può farti perdere denaro rapidamente, e nulla di tutto questo è un consiglio di investimento. Opera solo con ciò che puoi permetterti di perdere, e controlla lo storico delle performance prima di collegare qualsiasi cosa.