Cómo conectar tu clave API de OKX y solucionar el error 50119

Tu clave API de OKX puede ser válida y aun así devolver «La clave API no existe». Si una clave de EEA llega a la API global en lugar de a la infraestructura de OKX Europe, volver a crearla no resolverá el problema. Te mostraré cómo conectar tu clave API de OKX, elegir la región correcta de la cuenta y diagnosticar el error antes de cambiar las credenciales.

La comprobación crucial es la combinación de credenciales y endpoint regional. Una clave copiada correctamente y enviada al host regional equivocado puede fallar antes de que sus permisos sean relevantes.

Una clave API de OKX válida puede fallar en el endpoint regional equivocado

Ante una conexión fallida, resulta tentador generar otra clave, volver a pegarla y probar con más permisos. Ese enfoque trata cada fallo de autenticación como un problema de credenciales.

La estructura regional de OKX hace que esa suposición no sea fiable.

OKX Europe Limited es una entidad independiente regulada bajo MiCA, con licencia de la MFSA de Malta. Las cuentas de EEA se alojan en my.okx.com, y sus claves API solo son válidas en la infraestructura API de OKX Europe.

Envía una clave de EEA perfectamente válida a la API global de www.okx.com, y la respuesta puede ser 50119: «La clave API no existe». La clave existe, pero la solicitud ha llegado al endpoint regional equivocado.

Las cuentas de US tienen su propio host regional, us.okx.com. Sus conexiones también necesitan la infraestructura regional correspondiente.

Las cuentas brasileñas de OKX utilizan la plataforma global y la misma API, así que selecciona Global. La presencia en un mercado local no implica automáticamente una región API independiente.

Empiezo el diagnóstico por aquí porque cambiar una frase de contraseña o ampliar los permisos no puede corregir una discrepancia regional. La solicitud debe llegar a la infraestructura que reconoce la clave.

Cómo crear una clave API de OKX con los permisos que necesitas

Una conexión debe recibir acceso suficiente para realizar la tarea prevista. Conceder permisos adicionales para que desaparezca un error es un mal método de diagnóstico.

Para consultar tu cartera, utiliza Read. Añade Trade solo cuando vayas a utilizar bots que coloquen órdenes.

Nunca habilites Withdrawal para esta conexión.

Configuración de una clave API de OKX paso a paso

1. Abre la gestión de API en tu cuenta de OKX.

Inicia sesión en la cuenta que quieras conectar y accede a su área de gestión de API. Determina si esa cuenta pertenece a Global, EEA o US antes de crear la clave.

1. Crea una clave API exclusiva para la conexión.

Dale un nombre reconocible para identificar su propósito cuando revises los accesos más adelante. Una clave exclusiva también facilita cambiar o revocar el acceso de esta conexión por separado.

1. Establece la frase de contraseña de la API durante la creación.

Es una frase de contraseña que eliges para la clave API. No es la contraseña de tu cuenta de OKX, y la necesitarás junto con la clave API y el secreto al conectarte.

1. Habilita Read para consultar tu cartera.

Si tu objetivo es consultar la información de tu cartera, empieza con el acceso Read. Una conexión destinada únicamente a consultar información no necesita permiso para operar.

1. Añade Trade solo para bots que necesiten colocar órdenes.

El permiso Trade autoriza la actividad de trading. Habilítalo deliberadamente para ese fin, no como un experimento para resolver un error de autenticación.

1. Deja Withdrawal deshabilitado.

Consultar la cartera y colocar órdenes mediante bots no requiere permiso de retirada. No lo concedas para completar esta configuración. Ten presente que deshabilitar las retiradas no evita las pérdidas de trading: una clave con permiso Trade puede seguir colocando órdenes que generen pérdidas, así que limita los fondos de la cuenta a la que tenga acceso una conexión de trading.

1. Vincula la clave a las direcciones IP de la conexión cuando estén disponibles.

Utiliza las direcciones IP especificadas por el servicio que realiza las solicitudes API. Mantén esa configuración alineada con la conexión que realmente utilizas.

1. Guarda de forma segura la clave API, el secreto y la frase de contraseña.

Trátalos como credenciales. Al introducirlos en el formulario de conexión, comprueba que cada valor esté completo y pertenezca a la misma clave API.

Crear la clave es solo una parte de la configuración. La conexión que la recibe también debe saber qué host regional utilizar.

Por qué importa la lista de IP permitidas

La vinculación a direcciones IP restringe desde dónde se puede utilizar una clave. También influye en su ciclo de vida: OKX puede eliminar las claves API inactivas que no estén vinculadas a ninguna IP, por lo que una clave que creaste y dejaste sin usar podría haber dejado de existir cuando vuelvas a utilizarla.

No des por hecho que una clave sigue activa simplemente porque aún tienes sus credenciales guardadas. Comprueba su estado en la gestión de API de OKX.

Hay otro problema de configuración al que debes prestar atención: una clave activa puede rechazar una solicitud cuando la IP de quien la realiza no figura en su lista de IP permitidas. Eso produce un error específico de IP, que debe llevarte a revisar la configuración de IP en lugar de volver a crear la clave.

Por qué OKX dice «La clave API no existe» cuando la clave es válida

La frase suena definitiva. Su significado para el diagnóstico es más limitado de lo que parece.

Para una cuenta de EEA, el error 50119 puede significar que el endpoint global no reconoce una clave que sí es válida en la infraestructura de OKX Europe. Si una guía de conexión nunca pregunta a qué entidad pertenece tu cuenta, no puede detectar este caso.

La separación regional está documentada; no es una teoría sobre las credenciales

Las preguntas frecuentes de la API de OKX para EEA documentan el contexto regional de my.okx.com y la validez de las claves exclusivamente para EEA. Los informes públicos de incidencias en Freqtrade, CCXT y Hummingbot también corroboran el patrón de usuarios de EEA que reciben «La clave API no existe» cuando su integración utiliza el host global.

Esos informes respaldan la comprobación del endpoint regional. No demuestran que todos los casos tengan la misma causa.

Mi conclusión para el diagnóstico es directa: verifica la región de la cuenta antes de sustituir una clave que OKX todavía muestra como activa. Si un conector asume que todas las cuentas utilizan la API global, crear claves una y otra vez deja intacta esa suposición.

También hay que comprobar otras causas del error 50119

Una discrepancia regional no es la única explicación. El mismo error también puede deberse a:

• Una clave de trading de demostración utilizada en el entorno equivocado. Confirma que las credenciales correspondan al entorno que espera la conexión.
• Una clave eliminada automáticamente. Comprueba si la clave sigue existiendo en la gestión de API de OKX.
• Un valor pegado de forma incompleta. Asegúrate de haber introducido la clave API completa.
• Una clave realmente desconocida. Confirma que las credenciales procedan de la cuenta que quieres conectar.

Yo comprobaría estas posibilidades en secuencia en lugar de cambiarlo todo a la vez. Si sustituyes las credenciales, los permisos, el entorno y la región al mismo tiempo, un nuevo intento exitoso te dice muy poco sobre qué estaba fallando.

La pregunta útil es: ¿Reconoce este endpoint esta clave activa para esta cuenta y este entorno?

Interpreta el código de error de OKX antes de volver a intentarlo

Una conexión fallida es un síntoma. El código de error de OKX es una evidencia más útil.

La referencia pública de códigos de error de la API de OKX distingue entre una clave desconocida, una frase de contraseña incorrecta, una firma no válida y una restricción de IP. Cada caso apunta a una parte diferente de la conexión.

Código de error	Significado	Qué comprobar
50119	La clave API no existe	Región de la cuenta y host regional; entorno de demostración frente al previsto; si se eliminó la clave; si la clave pegada está completa
50105	Frase de contraseña de la API incorrecta	Utiliza la frase de contraseña establecida al crear esta clave API, no la contraseña de la cuenta
50113	Firma no válida	Comprueba el secreto de la API y la implementación de firma de solicitudes de la integración
50110	La IP de la solicitud no figura en la lista de IP permitidas	Comprueba si la IP de quien realiza la solicitud está incluida en la configuración de IP permitidas de la clave

Error 50105: comprueba la frase de contraseña de la API

La frase de contraseña de la API es una credencial independiente. Introducir en ese campo tu contraseña de inicio de sesión de OKX no cumple ese requisito.

Comprueba también que la frase de contraseña corresponda a la misma clave que la clave API y el secreto. Mezclar credenciales de distintos intentos de creación puede dejarte con valores que parecen válidos por separado, pero que no corresponden entre sí.

Error 50113: investiga la firma de las solicitudes

Una firma no válida apunta a la firma de autenticación de la solicitud. Comprueba el secreto de la API y, si mantienes la integración, su implementación de firma.

Si utilizas un formulario de conexión, consulta al soporte del conector o su documentación técnica para investigar la firma de solicitudes. Habilitar Trade o Withdrawal no soluciona una firma no válida.

Error 50110: revisa la lista de IP permitidas

Este error te dirige a la configuración de IP permitidas. Verifica la IP utilizada por el servicio que realiza la solicitud y compárala con la lista de IP permitidas de la clave.

Repetir a ciegas la misma solicitud mantiene la discrepancia. Corrige el ajuste correspondiente antes de volver a probar.

Cómo conectar OKX a Anny

Mi formulario de conexión incluye un selector de Región de la cuenta con las opciones Global, EEA y US. Esa selección garantiza que la clave se verifique en el host regional adecuado.

Este es el proceso de conexión:

1. Abre el formulario para añadir un exchange y elige OKX.

Ten a mano tu clave API, el secreto y la frase de contraseña de la API.

1. Selecciona la Región de la cuenta.

Elige EEA para una cuenta de OKX Europe, US para una cuenta de OKX US o Global para una cuenta de la plataforma global. Las cuentas brasileñas deben seleccionar Global.

1. Introduce las credenciales correspondientes.

Pega la clave API y el secreto completos y, después, introduce la frase de contraseña que estableciste al crear la clave.

1. Confirma que los permisos correspondan a tu propósito.

Utiliza Read para consultar tu cartera. Añade Trade solo para bots y deja Withdrawal deshabilitado.

1. Verifica la conexión.

Si falla, utiliza el código de error devuelto para decidir qué comprobar a continuación. Para 50119, revisa la región antes de crear otra clave.

Conecta OKX a Anny

Seleccionar una región es un requisito de autenticación, no una preferencia de visualización. Determina dónde se comprueban las credenciales.

Cómo utilizar la documentación de la API de OKX para resolver problemas

Si te conectas mediante un formulario existente, el selector de región y la tabla de errores son los puntos de partida prácticos. Si mantienes una integración, lee las indicaciones regionales junto con la documentación de autenticación.

Las partes relevantes de la documentación de la API de OKX responden a preguntas diferentes:

• Indicaciones regionales de la API: ¿Qué infraestructura debe recibir las solicitudes de esta cuenta?
• Indicaciones de autenticación: ¿Qué credenciales se requieren y cómo deben firmarse las solicitudes?
• Referencia de códigos de error: ¿Qué parte de la solicitud enviada se rechazó?

Una implementación correcta de la firma puede seguir enviando una solicitud al host regional equivocado. Un host regional correcto puede seguir rechazando una frase de contraseña incorrecta.

Mantengo esas comprobaciones separadas porque conducen a correcciones diferentes. Para que una conexión funcione, el endpoint, las credenciales, el entorno, los permisos y la configuración de IP deben ser coherentes entre sí.

Preguntas frecuentes sobre las conexiones API de OKX

¿Caduca una clave API de OKX?

No des por hecho que una clave API seguirá disponible indefinidamente. OKX puede eliminar las claves inactivas que no estén vinculadas a ninguna IP, así que revisa la gestión de API si unas credenciales guardadas anteriormente dejan de funcionar.

Vincula la clave a las direcciones IP especificadas para la conexión cuando estén disponibles y verifica que siga activa antes de investigar su frase de contraseña o sus permisos.

¿Por qué mi clave API de OKX válida dice que no existe?

Una clave válida puede devolver 50119 cuando se envía al endpoint regional equivocado. En particular, una clave de EEA corresponde a la infraestructura de OKX Europe; enviarla a la API global de www.okx.com puede producir «La clave API no existe».

Comprueba también si hay una discrepancia con el entorno de demostración, una clave eliminada automáticamente o un valor pegado de forma incompleta.

¿Qué permisos necesita un bot de trading de OKX?

Utiliza Read para consultar la cartera y añade Trade cuando el bot necesite colocar órdenes. Nunca habilites Withdrawal para esta conexión.

Los permisos adicionales no solucionan una discrepancia regional, una frase de contraseña incorrecta, una firma no válida ni un error en la lista de IP permitidas.

¿La frase de contraseña de la API de OKX es la misma que mi contraseña?

No. La frase de contraseña de la API se establece al crear la clave API y es independiente de la contraseña de tu cuenta de OKX.

Introduce la frase de contraseña asociada a esa clave específica.

¿Qué región debe seleccionar una cuenta brasileña de OKX?

Selecciona Global. OKX Brazil opera en la plataforma global y utiliza la misma API.

¿Debo crear una clave nueva cada vez que falla la conexión?

No. Lee primero el código de error y comprueba el ajuste que señala.

Para 50119, confirma el host regional, el entorno, el estado activo de la clave y que el valor pegado esté completo. Una clave nueva no reparará una conexión que sigue enviándola al endpoint regional equivocado.

La siguiente acción útil es un diagnóstico, no otro intento idéntico. Empieza por la región, lee el código y cambia el ajuste al que apunte la evidencia.

Este artículo es educativo y no constituye asesoramiento financiero. Rendimiento pasado ≠ resultados futuros. Anny es una plataforma de análisis impulsada por IA, no un asesor de inversiones registrado.