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.
¿Aún no tienes cuenta en OKX? Regístrate en 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.
Dale las tres al programa de trading automático. Si falta una, no puede conectarse.
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.
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ódigo | Significado | Qué hacer |
|---|---|---|
| Primer grupo: problemas de clave y permisos, rechazados nada más conectar o enviar la orden | ||
| 50111 | API key no válida | Comprueba que esté bien pegada y sin espacios de más al principio o al final |
| 50113 | Firma no válida | Suele ser la secret key mal pegada. Pégala de nuevo |
| 50105 | Passphrase incorrecta | Pon la que definiste al crear la clave, no tu contraseña de acceso |
| 50110 | La IP no está en la lista blanca | Añade la nueva IP de la máquina que ejecuta el programa a la lista blanca |
| 50119 | La clave no existe | Puede que se haya borrado (por ejemplo, por la regla de los 14 días). Crea otra |
| 50100 | API congelada | Contacta con el soporte de OKX |
| Segundo grupo: la clave está bien, pero esta orden no puede salir | ||
| 51010 | El modo de cuenta actual no lo admite | En Spot mode no se pueden operar futuros. Cambia a un modo que los admita en el ajuste de modo de cuenta |
| 51008 | Margen insuficiente | Añade fondos o baja el importe de la estrategia |
| 51020 | Por debajo del tamaño mínimo de orden | Sube el importe de la estrategia o elige una moneda con una unidad mínima más pequeña |
| 50102 | Marca de tiempo de la solicitud caducada | El 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 | ||
| 50004 | Tiempo de espera agotado en la solicitud de API | No la reenvíes. Revisa la orden primero |
| 51149 | Tiempo de espera agotado al enviar la orden | No la reenvíes. Revisa la orden primero |
| 50001 | Servicio no disponible temporalmente | No la reenvíes. Revisa la orden primero |
| 50026 | Error del sistema | No 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.
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 escritorioPara 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.
¿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.
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.