Come collegare OKX a ZeroLoss: configurazione della API key
ZeroLoss fa trading sugli swap perpetui con margine in USDT di OKX direttamente sul tuo account OKX. Si collega tramite una API key che crei tu su OKX, non tramite la tua password, e alla chiave bastano i permessi per leggere il tuo account e fare trading sui futures. I tuoi soldi restano sempre su OKX. Questa guida spiega come creare la chiave, limitarla e collegarla a ZeroLoss. Ci vogliono circa cinque minuti.
Vuoi vedere il bot all'opera prima di collegare qualsiasi cosa? Il paper test gratuito di 7 giorni non richiede alcun exchange.
Prima di iniziare
- Un account OKX con autenticazione a due fattori attiva. Se ti trovi nel SEE usa eea.okx.com, negli Stati Uniti us.okx.com: le chiavi di un sito non funzionano sugli altri. In alcune regioni OKX richiede almeno 100 USD in asset prima di consentirti di creare una chiave.
- Una modalità account che consenta i futures. In Trade settings → Account mode, scegli qualsiasi modalità diversa da Spot mode: la modalità Spot blocca il trading sui contratti. Puoi cambiarla solo dal sito web o dall'app.
- Almeno 100 USDT nel tuo Trading account. Usa Assets → Transfer, dal Funding account al Trading account.
- Un account ZeroLoss. Puoi iniziare con il paper test gratuito e collegare l'exchange in un secondo momento.
Passo 1: crea la API key su OKX
- Sul sito di OKX apri Profile → API and connections (nell'app: Menu → API), poi Create API key (crea API key).
- Dai un nome alla chiave, scegli il tuo main account (account principale), oppure il sub-account che contiene gli USDT, e come finalità il trading tramite API per uso personale.
- Aggiungi la allowlist degli IP (passo 3) e i permessi (passo 2).
- Imposta una passphrase. Scegline una robusta, con lettere maiuscole e minuscole, un numero e un simbolo, e annotala: OKX non può mostrarla né recuperarla, e ZeroLoss ne ha bisogno.
- Conferma, poi copia la API key e la Secret key.
Passo 2: scegli i permessi
- Read: attivo.
- Trade: attivo. Serve per inserire e annullare ordini.
- Withdraw (prelievo): disattivato.
- Transfer, Loan ed Earn: disattivati. ZeroLoss non ne ha mai bisogno.
Passo 3: limita la key agli indirizzi IP di ZeroLoss
Limitare una chiave a pochi indirizzi IP significa che funziona solo da quei server, anche se qualcuno l'avesse copiata. Nell'app ZeroLoss apri Collega exchange: il passaggio Aggiungi i nostri IP elenca gli indirizzi dei server di ZeroLoss con un pulsante Copia tutti. Incollali nel campo della restrizione IP su OKX.
OKX accetta fino a 20 indirizzi per chiave, separati da virgole o spazi. Una chiave di trading senza allowlist IP viene eliminata automaticamente dopo 14 giorni di inutilizzo; le chiavi con allowlist non scadono.
Passo 4: collega la key in ZeroLoss
- Accedi a ZeroLoss e apri Collega exchange.
- In 1 · Pick your exchange, scegli OKX.
- In 2 · Paste your API key, incolla la tua API key, la secret key e la passphrase. La passphrase è quella che hai digitato quando hai creato la chiave su OKX; OKX non può mostrartela di nuovo.
- Clicca Verify & connect. ZeroLoss verifica la chiave e legge il tuo saldo futures. Per la connessione servono almeno 100 USDT nel tuo conto Trading di OKX.
Verifica che la key sia sicura
Apri la pagina di gestione API su OKX e controlla la chiave che hai creato. Deve consentire la lettura e il trading di futures, con i prelievi disattivati. Per fermare ZeroLoss in qualsiasi momento, elimina la chiave su OKX: il trading tramite quella chiave si interrompe subito, senza alcun intervento da parte nostra. La nostra guida alle API key di solo trading spiega perché è questa l'impostazione che conta.
Problemi comuni
- Ordini rifiutati anche se la chiave è corretta: il conto è in modalità Spot. Cambia la modalità del conto nelle impostazioni di trading di OKX.
- Chiave, secret e passphrase sembrano giuste ma non funzionano: devono provenire tutte dallo stesso account (principale o subaccount) e dal sito regionale corretto (okx.com, eea.okx.com o us.okx.com).
- Passphrase persa: OKX non può mostrartela. Elimina la chiave e creane una nuova.
- “Invalid API Key or Secret”: durante la copia è saltato un carattere. Copia di nuovo entrambe; se non hai salvato la secret, elimina la key e creane una nuova.
- “API key missing required permissions”: sulla key non è spuntato il trading sui futures o la lettura. Modifica la key o creane una nuova con entrambi i permessi.
- “API IP restriction issue”: la key è limitata, ma non a tutti gli indirizzi di ZeroLoss. Usa Copia tutti nell'app e incolla di nuovo l'elenco completo.
- “Minimum 100 USDT required in Futures wallet”: i tuoi USDT sono nel conto Funding. Trasferiscili nel conto Trading su OKX e riprova.
Il trading di futures sulle criptovalute comporta un rischio elevato di perdite, e l'automazione non lo elimina. Le schermate degli exchange cambiano di tanto in tanto: se un menu ti sembra diverso, cerca i nomi dei permessi indicati sopra. Questa pagina fornisce informazioni generali e non costituisce consulenza finanziaria. Consulta il nostro Disclaimer su rischi e responsabilità.