Come collegare la tua chiave API OKX e risolvere l'errore 50119

La tua chiave API OKX può essere valida e restituire comunque “La chiave API non esiste.” Se una chiave EEA raggiunge l'API globale anziché l'infrastruttura di OKX Europe, ricrearla non risolverà il problema. Ti mostrerò come collegare la tua chiave API OKX, scegliere la regione corretta dell'account e diagnosticare l'errore prima di cambiare le credenziali.

La verifica cruciale riguarda la combinazione di credenziali ed endpoint regionale. Una chiave copiata correttamente ma inviata all'host regionale sbagliato può fallire prima che i suoi permessi diventino rilevanti.

Una chiave API OKX valida può fallire sull'endpoint regionale sbagliato

Di fronte a una connessione fallita, la tentazione è generare un'altra chiave, incollarla di nuovo e provare ad aggiungere permessi. Questo approccio tratta ogni errore di autenticazione come un problema di credenziali.

La struttura regionale di OKX rende questa ipotesi inaffidabile.

OKX Europe Limited è un'entità separata, regolamentata ai sensi del MiCA e autorizzata dalla MFSA di Malta. Gli account EEA risiedono su my.okx.com e le loro chiavi API sono valide esclusivamente sull'infrastruttura API di OKX Europe.

Invia una chiave EEA perfettamente valida all'API globale www.okx.com e la risposta può essere 50119: “La chiave API non esiste.” La chiave esiste, ma la richiesta ha raggiunto l'endpoint regionale sbagliato.

Gli account US hanno un proprio host regionale, us.okx.com. Anche le loro connessioni richiedono l'infrastruttura regionale corrispondente.

Gli account OKX brasiliani usano la piattaforma globale e la stessa API, quindi seleziona Global. La presenza in un mercato locale non implica automaticamente una regione API separata.

Parto da qui per diagnosticare il problema, perché cambiare una passphrase o ampliare i permessi non può correggere una mancata corrispondenza regionale. La richiesta deve raggiungere l'infrastruttura che riconosce la chiave.

Come creare una chiave API OKX con i permessi necessari

Una connessione deve ricevere accesso sufficiente a svolgere il compito previsto. Concedere permessi aggiuntivi per far sparire un errore è un metodo diagnostico inadeguato.

Per visualizzare il portafoglio, usa Read. Aggiungi Trade solo se intendi usare bot che inseriscono ordini.

Non abilitare mai Withdrawal per questa connessione.

Configurazione della chiave API OKX passo dopo passo

1. Apri la gestione API nel tuo account OKX.

Accedi all'account che vuoi collegare e vai alla sua area di gestione API. Stabilisci se l'account appartiene a Global, EEA o US prima di creare la chiave.

1. Crea una chiave API dedicata alla connessione.

Assegnale un nome riconoscibile, così potrai identificarne lo scopo quando controllerai gli accessi in seguito. Una chiave dedicata rende anche più semplice modificare o revocare separatamente l'accesso di questa connessione.

1. Imposta la passphrase API durante la creazione.

È una passphrase che scegli per la chiave API. Non è la password del tuo account OKX e ti servirà insieme alla chiave API e al secret per effettuare la connessione.

1. Abilita Read per visualizzare il portafoglio.

Se il tuo obiettivo è consultare le informazioni del portafoglio, inizia con l'accesso Read. Una connessione destinata alla sola consultazione non richiede il permesso di trading.

1. Aggiungi Trade solo per i bot che devono inserire ordini.

Il permesso Trade autorizza l'attività di trading. Abilitalo consapevolmente per questo scopo, non come esperimento per risolvere un errore di autenticazione.

1. Lascia Withdrawal disabilitato.

La visualizzazione del portafoglio e l'inserimento di ordini tramite bot non richiedono il permesso di prelievo. Non concederlo per completare questa configurazione. Ricorda che disabilitare i prelievi non impedisce le perdite da trading: una chiave con il permesso Trade può comunque inserire ordini che generano perdite, quindi limita i fondi presenti nell'account a cui una connessione di trading può accedere.

1. Associa la chiave agli indirizzi IP della connessione, se disponibili.

Usa gli indirizzi IP indicati dal servizio che effettua le richieste API. Mantieni questa configurazione allineata alla connessione che usi effettivamente.

1. Conserva in modo sicuro la chiave API, il secret e la passphrase.

Trattali come credenziali. Quando li inserisci nel modulo di connessione, verifica che ogni valore sia completo e appartenga alla stessa chiave API.

Creare la chiave è solo una parte della configurazione. Anche la connessione che la riceve deve sapere quale host regionale usare.

Perché la whitelist IP è importante

L'associazione agli IP limita i punti da cui una chiave può essere utilizzata. Conta anche per il ciclo di vita della chiave: OKX può eliminare le chiavi API inattive che non sono associate a indirizzi IP, quindi una chiave che hai creato e lasciato inutilizzata potrebbe non esistere più quando torni a usarla.

Non presumere che una chiave sia ancora attiva solo perché ne hai ancora le credenziali salvate. Controllane lo stato nella gestione API di OKX.

C'è un altro problema di configurazione da tenere presente: una chiave attiva può rifiutare una richiesta quando l'IP del richiedente non è presente nella sua whitelist. Questo produce un errore specifico relativo all'IP, che dovrebbe indirizzarti alle impostazioni IP anziché alla creazione di una nuova chiave.

Perché OKX dice “La chiave API non esiste” quando la chiave è valida

La frase sembra definitiva. Il suo significato diagnostico è più circoscritto di quanto appaia.

Per un account EEA, l'errore 50119 può significare che l'endpoint globale non riconosce una chiave valida sull'infrastruttura di OKX Europe. Se una guida alla connessione non chiede mai a quale entità appartenga il tuo account, non può far emergere questo caso.

La separazione regionale è documentata, non è una teoria sulle credenziali

Le FAQ dell'API OKX EEA documentano il contesto regionale di my.okx.com e la validità delle chiavi limitata all'EEA. Anche le segnalazioni pubbliche di problemi in Freqtrade, CCXT e Hummingbot confermano il caso ricorrente di utenti EEA che ricevono “La chiave API non esiste” quando la loro integrazione usa l'host globale.

Queste segnalazioni giustificano il controllo dell'endpoint regionale. Non dimostrano che ogni caso abbia la stessa causa.

La mia conclusione diagnostica è semplice: verifica la regione dell'account prima di sostituire una chiave che OKX indica ancora come attiva. Se un connettore presume che ogni account usi l'API globale, creare ripetutamente nuove chiavi lascia intatta questa ipotesi.

Vanno controllate anche le altre cause dell'errore 50119

Una mancata corrispondenza regionale non è l'unica spiegazione. Lo stesso errore può riguardare anche:

• Una chiave per il trading demo usata nell'ambiente sbagliato. Verifica che le credenziali corrispondano all'ambiente previsto dalla connessione.
• Una chiave eliminata automaticamente. Controlla se la chiave esiste ancora nella gestione API di OKX.
• Un valore incollato incompleto. Assicurati che sia stata inserita l'intera chiave API.
• Una chiave effettivamente sconosciuta. Verifica che le credenziali provengano dall'account previsto.

Controllerei queste possibilità in sequenza, invece di cambiare tutto insieme. Se sostituisci contemporaneamente credenziali, permessi, ambiente e regione, un nuovo tentativo riuscito ti dice ben poco su quale fosse il problema.

La domanda utile è: questo endpoint riconosce questa chiave attiva per questo account e questo ambiente?

Interpreta il codice di errore OKX prima di riprovare

Una connessione fallita è un sintomo. Il codice di errore OKX è l'indizio più utile.

La documentazione pubblica dei codici di errore dell'API OKX distingue una chiave sconosciuta da una passphrase errata, una firma non valida e una restrizione IP. Ognuno rimanda a una parte diversa della connessione.

Codice di errore	Significato	Cosa controllare
50119	La chiave API non esiste	Regione dell'account e host regionale; ambiente demo rispetto a quello previsto; eventuale eliminazione della chiave; completezza della chiave incollata
50105	Passphrase API errata	Usa la passphrase impostata alla creazione di questa chiave API, non la password dell'account
50113	Firma non valida	Controlla il secret API e l'implementazione della firma delle richieste nell'integrazione
50110	L'IP della richiesta non è nella whitelist	Controlla se l'IP del richiedente è incluso nella configurazione degli IP consentiti per la chiave

Errore 50105: controlla la passphrase API

La passphrase API è una credenziale separata. Inserire in quel campo la password di accesso a OKX non soddisfa il requisito.

Controlla anche che la passphrase appartenga alla stessa chiave della chiave API e del secret. Mescolare credenziali provenienti da diversi tentativi di creazione può lasciarti con valori che sembrano plausibili singolarmente, ma non appartengono allo stesso insieme.

Errore 50113: indaga sulla firma delle richieste

Una firma non valida rimanda alla firma di autenticazione della richiesta. Controlla il secret API e, se gestisci l'integrazione, la sua implementazione della firma.

Se usi un modulo di connessione, consulta l'assistenza o la documentazione tecnica del connettore per indagare sulla firma delle richieste. Abilitare Trade o Withdrawal non risolve una firma non valida.

Errore 50110: esamina la whitelist IP

Questo errore ti indirizza alla configurazione degli IP consentiti. Verifica l'IP usato dal servizio che effettua la richiesta, poi confrontalo con la whitelist della chiave.

Ripetere alla cieca la stessa richiesta lascia invariata la mancata corrispondenza. Correggi l'impostazione pertinente prima di riprovare.

Come collegare OKX ad Anny

Il mio modulo di connessione include un selettore Regione dell'account con le opzioni Global, EEA e US. Questa selezione assicura che la chiave venga verificata sull'host regionale appropriato.

Ecco la procedura di connessione:

1. Apri il modulo per aggiungere un exchange e scegli OKX.

Tieni a portata di mano la chiave API, il secret e la passphrase API.

1. Seleziona la Regione dell'account.

Scegli EEA per un account OKX Europe, US per un account OKX US oppure Global per un account sulla piattaforma globale. Gli account brasiliani devono selezionare Global.

1. Inserisci le credenziali corrispondenti.

Incolla la chiave API e il secret completi, poi inserisci la passphrase che hai impostato alla creazione della chiave.

1. Conferma che i permessi corrispondano al tuo scopo.

Usa Read per visualizzare il portafoglio. Aggiungi Trade solo per i bot e lascia Withdrawal disabilitato.

1. Verifica la connessione.

Se fallisce, usa il codice di errore restituito per scegliere il controllo successivo. Per 50119, ricontrolla la regione prima di creare un'altra chiave.

Collega OKX ad Anny

Selezionare una regione è un requisito di autenticazione, non una preferenza di visualizzazione. Determina dove vengono verificate le credenziali.

Come usare la documentazione API di OKX per diagnosticare i problemi

Se ti colleghi attraverso un modulo esistente, il selettore della regione e la tabella degli errori sono i punti di partenza pratici. Se gestisci un'integrazione, leggi le indicazioni regionali insieme alla documentazione sull'autenticazione.

Le sezioni pertinenti della documentazione API di OKX rispondono a domande diverse:

• Indicazioni sulle API regionali: quale infrastruttura deve ricevere le richieste di questo account?
• Indicazioni sull'autenticazione: quali credenziali sono richieste e come devono essere firmate le richieste?
• Riferimento dei codici di errore: quale parte della richiesta inviata è stata rifiutata?

Un'implementazione corretta della firma può comunque inviare una richiesta all'host regionale sbagliato. Un host regionale corretto può comunque rifiutare una passphrase errata.

Tengo separati questi controlli perché portano a correzioni diverse. Una connessione riuscita richiede che endpoint, credenziali, ambiente, permessi e configurazione IP siano coerenti tra loro.

Domande frequenti sulle connessioni API OKX

Una chiave API OKX scade?

Non presumere che una chiave API rimanga disponibile a tempo indeterminato. OKX può eliminare le chiavi inattive che non sono associate a indirizzi IP, quindi controlla la gestione API se credenziali salvate in precedenza smettono di funzionare.

Associa la chiave agli indirizzi IP specificati per la connessione, se disponibili, e verifica che sia ancora attiva prima di indagare sulla passphrase o sui permessi.

Perché la mia chiave API OKX valida risulta inesistente?

Una chiave valida può restituire 50119 quando viene inviata all'endpoint regionale sbagliato. In particolare, una chiave EEA deve essere usata sull'infrastruttura di OKX Europe; inviarla all'API globale www.okx.com può produrre “La chiave API non esiste.”

Controlla anche che non ci sia una mancata corrispondenza con l'ambiente demo, una chiave eliminata automaticamente o un valore incollato incompleto.

Di quali permessi ha bisogno un bot di trading OKX?

Usa Read per visualizzare il portafoglio e aggiungi Trade quando il bot deve inserire ordini. Non abilitare mai Withdrawal per questa connessione.

I permessi aggiuntivi non risolvono una mancata corrispondenza regionale, una passphrase errata, una firma non valida o un errore della whitelist IP.

La passphrase API OKX è uguale alla mia password?

No. La passphrase API viene impostata quando crei la chiave API ed è distinta dalla password del tuo account OKX.

Inserisci la passphrase associata a quella specifica chiave.

Quale regione deve selezionare un account OKX brasiliano?

Seleziona Global. OKX Brazil opera sulla piattaforma globale e usa la stessa API.

Devo creare una nuova chiave ogni volta che la connessione fallisce?

No. Leggi prima il codice di errore e controlla l'impostazione che identifica.

Per 50119, verifica l'host regionale, l'ambiente, lo stato attivo della chiave e la completezza del valore incollato. Una nuova chiave non correggerà una connessione che continua a inviarla all'endpoint regionale sbagliato.

La prossima azione utile è una diagnosi, non un altro tentativo identico. Parti dalla regione, leggi il codice e modifica l'impostazione indicata dagli elementi disponibili.

Questo articolo ha finalità educative e non costituisce consulenza finanziaria. Le performance passate ≠ i risultati futuri. Anny è una piattaforma di analisi basata sull'AI, non un consulente per gli investimenti registrato.