API de OKX: crea la clave, permisos y trading automático

Desde crear la clave de API, elegir permisos y configurar la lista blanca de IP hasta qué significa cada código de error cuando se rechaza una orden y qué hacer.

Última actualización 2026-11
Aviso: los enlaces de registro de OKX de este artículo son enlaces de afiliado de Blave. Si te registras con ellos, Blave puede recibir una comisión.

¿Aún no tienes cuenta en OKX? Regístrate en OKX

Puntos clave
  • Una clave de API de OKX tiene tres partes: API key, secret key y passphrase. La passphrase la eliges tú y, si la olvidas, solo puedes borrar la clave y crear otra.
  • El trading automático solo necesita los permisos Read y Trade. Nunca actives Withdraw.
  • OKX borra automáticamente una clave con permiso de operación y sin IP vinculada tras 14 días sin actividad.
  • Que una orden devuelva el tiempo agotado 50004 o 51149 no significa que no se haya ejecutado. Revisa la orden primero y no la reenvíes sin más.

¿Qué es la API de OKX?

La API de OKX es la vía para que un programa hable directamente con tu cuenta de OKX: consultar saldo y posiciones, enviar y cancelar órdenes, todo sin abrir la web. Los programas de trading automático envían órdenes según sus reglas a través de la API.

Para usar la API hay que crear antes una clave. Con ella el programa demuestra que tiene autorización de tu cuenta. Lo que puede hacer la clave depende de los permisos que actives al crearla.

¿Cómo se crea una clave de API de OKX?

Crear cuenta en OKX
Nunca actives el permiso de retiro. El trading automático solo necesita lectura y operación. Aunque la clave se filtre, sin permiso de retiro nadie puede sacar tus monedas.
  1. Inicia sesión en la web de OKX, ve a Profile → API and connections y pulsa Create API key.
  2. Escribe un nombre para la clave de API y elige la cuenta y el uso.
  3. Configura la lista blanca de IP (ver la siguiente sección).
  4. Marca los permisos Read y Trade. No marques Withdraw.
  5. Define una passphrase y apúntala. OKX no la vuelve a mostrar después de crear la clave.
  6. Completa la verificación de seguridad, apunta la API key y la secret key y guárdalas en un lugar seguro.

Dale las tres al programa de trading automático. Si falta una, no puede conectarse.

¿Hay que configurar la lista blanca de IP?

La FAQ oficial de la API de OKX lo dice claro: una clave con permiso de operación o de retiro y sin IP vinculada se borra automáticamente tras 14 días sin actividad. Con una IP vinculada, la clave no caduca por inactividad y quien la consiga no puede usarla desde otro lugar. Cada clave admite hasta 20 IP.

Si la vinculas, pon la IP pública de la máquina que ejecuta el programa, no la de tu móvil ni la de tu conexión habitual. La IP de casa puede cambiar y, cuando cambie, hay que añadir la nueva a la lista blanca.

Con Blave Agent, el cuadro de conexión del servidor en la nube muestra su IP, así que basta con copiarla. La app de escritorio no exige vincularla, pero si no lo haces, recuerda la regla de los 14 días.

Códigos de error frecuentes de la API de OKX

Estos son los errores que más aparecen en el trading automático. El significado sigue la documentación oficial de la API de OKX (el 51008, la clasificación del programa de órdenes de Blave) y la solución es un consejo general.

CódigoSignificadoQué hacer
Primer grupo: problemas de clave y permisos, rechazados nada más conectar o enviar la orden
50111API key no válidaComprueba que esté bien pegada y sin espacios de más al principio o al final
50113Firma no válidaSuele ser la secret key mal pegada. Pégala de nuevo
50105Passphrase incorrectaPon la que definiste al crear la clave, no tu contraseña de acceso
50110La IP no está en la lista blancaAñade la nueva IP de la máquina que ejecuta el programa a la lista blanca
50119La clave no existePuede que se haya borrado (por ejemplo, por la regla de los 14 días). Crea otra
50100API congeladaContacta con el soporte de OKX
Segundo grupo: la clave está bien, pero esta orden no puede salir
51010El modo de cuenta actual no lo admiteEn Spot mode no se pueden operar futuros. Cambia a un modo que los admita en el ajuste de modo de cuenta
51008Margen insuficienteAñade fondos o baja el importe de la estrategia
51020Por debajo del tamaño mínimo de ordenSube el importe de la estrategia o elige una moneda con una unidad mínima más pequeña
50102Marca de tiempo de la solicitud caducadaEl reloj de la máquina que ejecuta el programa va desfasado. Activa la sincronización automática de hora
Tercer grupo: resultado incierto, el que requiere más cuidado
50004Tiempo de espera agotado en la solicitud de APINo la reenvíes. Revisa la orden primero
51149Tiempo de espera agotado al enviar la ordenNo la reenvíes. Revisa la orden primero
50001Servicio no disponible temporalmenteNo la reenvíes. Revisa la orden primero
50026Error del sistemaNo la reenvíes. Revisa la orden primero

La documentación de OKX dice claramente que 50004 y 51149 "no significan que la solicitud haya tenido éxito ni que haya fallado". La orden puede haberse ejecutado ya, y reenviarla la duplicaría. Ante estos cuatro códigos, Blave Agent nunca reenvía la misma orden: en una orden de mercado de futuros comprueba si se ejecutó antes de decidir el siguiente paso, y cualquier otra orden se detiene e informa, sin reintentos automáticos.

Si programas tú mismo la conexión con la API de OKX, aquí es donde más fácil es que algo salga mal.

Conecta OKX con Blave Agent y olvídate de todo esto

Todo el manejo de errores de arriba, incluido sincronizar la hora con OKX ante un 50102 y no reenviar tras un tiempo agotado, ya lo hace el programa de órdenes de Blave Agent. Solo tienes que pegar la API key, la secret key y la passphrase en Trading automático › Conectar cuenta › OKX, y la estrategia enviará órdenes a OKX según sus reglas.

Antes de conectar una cuenta real, conviene hacer paper trading un tiempo. No necesitas clave y empiezas con 100,000 USDT.

Descargar la app de escritorio

Para los pasos completos, consulta Configurar las claves de trading del exchange. Para todo el proceso desde la idea hasta operar en real, consulta Trading automático en OKX: de la idea a operar en real.

Preguntas frecuentes

¿Caducan las claves de API?
Una clave con IP vinculada no caduca por inactividad. Una con permiso de operación o de retiro y sin IP vinculada se borra tras 14 días sin actividad.

¿Qué hago si olvido la passphrase?
No se puede recuperar. Borra esta clave, crea otra y vuelve a pegar las tres partes nuevas en el programa.

¿A qué hora del día se agota más el tiempo de las órdenes?
OKX recomienda evitar las 8:00, 16:00 y 24:00 de cada día (hora de Taiwán, UTC+8). Son las liquidaciones de financiación, cuando los servidores van más cargados.

Los riesgos, primero

Una clave de API es la autorización para operar tu cuenta, así que no la pegues en webs ni programas en los que no confíes. Nunca actives el permiso de retiro y borra las claves que ya no uses. El trading automático no hace desaparecer las pérdidas, solo ejecuta las reglas. Con apalancamiento, las pérdidas también se amplían.