Errores de KuCoin
Códigos de error de KuCoin en LootX: key, secret y passphrase, permisos y lista blanca de IP, fondos insuficientes en spot y futuros, volumen en contratos y límites de solicitudes.
KuCoin responde con los campos code y msg: el código 200000 significa éxito; cualquier otro, rechazo. Los códigos son números de seis dígitos y el rechazo suele llegar con estado HTTP 200, así que hay que mirar el código. En KuCoin, spot y futuros son API distintas con conjuntos de códigos diferentes: por ejemplo, fondos insuficientes en spot es 200004, y en futuros, 300003.
La key de KuCoin consta de tres partes —key, secret y passphrase—, y el error puede estar en cualquiera. Si el terminal no reconoce el rechazo, en el mensaje emergente después de «Order:» verá la respuesta del exchange tal cual: KuCoin API 200004: Balance insufficient o KuCoin POST /orders HTTP 400: {"code":"…","msg":"…"}. El procedimiento general de análisis está en la página Mensajes de error: cómo leerlos; la configuración de las keys, en Conexión de exchanges y API keys.
Qué explica el propio terminal
| Situación | Códigos | Qué verá |
|---|---|---|
| El exchange no reconoció la key o la passphrase | 400003, 400004 |
Etiqueta «…: el exchange rechazó la API key o el secret —revíselos en la configuración de la conexión»; en la conexión, en Configuración → Conexiones, la sugerencia «El exchange rechazó la API key o el secret» |
| Firma incorrecta | 400005 |
Al conectar, la misma etiqueta; en la orden, «Orden rechazada: API key o secret incorrectos» |
| Key de generación antigua o nueva | — | Nada: KuCoin firma las keys de distintas generaciones de manera diferente, y el terminal selecciona automáticamente la variante correcta |
| Demasiadas solicitudes | HTTP 429 | Etiqueta «KuCoin: se superó el límite de solicitudes (429), restricción hasta … UTC». El terminal aplica la pausa por sí mismo |
| Reloj desincronizado | 400002 |
Nada: el terminal sincroniza la hora con KuCoin y repite la solicitud |
| La orden ya no existe | HTTP 404 con order_not_exist_or_not_allow_to_cancel |
Nada: el terminal consulta al exchange el estado final de la orden por sí mismo |
| Faltaron monedas al cerrar una posición spot | 200004, 300003, 100005 |
El terminal relee la wallet de inmediato y repite la venta hasta tres veces, cada vez con un volumen un poco menor —dentro del margen de la comisión—. Si no funciona, muestra el texto del exchange |
| No hay nada que cerrar en spot | — | «KuCoin …: no hay nada que vender —saldo … = 0, la posición ya está cerrada», con el nombre del par y de la moneda. La orden no se envía al exchange |
| El exchange suspendió el trading de la moneda por API | según las palabras de la respuesta | «Trading por API no disponible para esta moneda —restricción del exchange» |
El rechazo por lista blanca de IP (400006) o por permisos de la key (400007) llega en el mensaje de la orden como texto del exchange: la key en sí es correcta. Pero si el exchange rechaza de ese modo ya en la conexión, el terminal puede mostrar la misma etiqueta «el exchange rechazó la API key o el secret»; por eso, al verla, revise también los permisos y la lista blanca de IP de la key.
Códigos frecuentes
| Código | Cómo se ve | Causa | Qué hacer |
|---|---|---|---|
400003 |
Etiqueta «el exchange rechazó la API key o el secret» | La key no existe: se pegó con error o se eliminó | Revise la API Key; consulte El exchange rechazó la key |
400004 |
Etiqueta «el exchange rechazó la API key o el secret» | Passphrase incorrecta | Vuelva a pegar la Passphrase de la key |
400005 |
Etiqueta u «Orden rechazada: API key o secret incorrectos» | La firma no coincide: el secret no corresponde a la key | Vuelva a pegar el API Secret |
400001 |
Texto del exchange: «Any of KC-API-KEY, KC-API-SIGN, KC-API-TIMESTAMP, KC-API-PASSPHRASE is missing in your request header» | Uno de los tres campos de la key está vacío | Complete los tres campos de la conexión |
400002 |
Normalmente nada; ante un salto brusco del reloj, texto del exchange «KC-API-TIMESTAMP Invalid» | El reloj del equipo se desincronizó del exchange | Repita en un minuto. Si se repite, active la sincronización de hora en Windows |
400006 |
Texto del exchange: «The requested ip address is not on the api whitelist» | Su IP no está en la lista blanca de la key | Consulte Permisos y lista blanca de IP |
400007 |
Texto del exchange: «Access Denied» | La key no tiene permiso para esta acción | Active el permiso necesario en la key |
411100 |
Texto del exchange: «User is frozen» | La cuenta está congelada por KuCoin | Contacte al soporte de KuCoin |
200004 |
Texto del exchange en el mensaje de la orden: «Balance insufficient» | No hay fondos libres suficientes en la cuenta spot | Consulte Fondos insuficientes |
300003 |
Texto del exchange en el mensaje de la orden: «Balance not enough…» | No hay fondos suficientes en la cuenta de futuros | Deposite en la cuenta de futuros o reduzca el volumen |
102435 |
Texto del exchange en el mensaje de la orden: «Below the minimum order size» | El volumen es inferior al mínimo del par | Aumente el volumen |
300005 |
Texto del exchange en el mensaje de la orden: «The order will exceed the maximum risk limit of …» | La posición con esta orden superará el límite de riesgo | Reduzca el volumen o el apalancamiento |
300016 |
Texto del exchange: «The leverage cannot be greater than …» | Apalancamiento superior al permitido para el contrato | Elija un apalancamiento menor |
200001 |
Texto del exchange en el mensaje de la orden: «Order creation for this pair suspended» | El exchange no acepta temporalmente órdenes para el par | Espere o coloque la orden en el sitio web de KuCoin |
900001 |
Texto del exchange en el mensaje de la orden: «symbol does not exist» | El par no existe en este mercado de KuCoin | Verifique que la moneda esté abierta en el mercado correcto: spot o futuros |
429000 |
Texto del exchange: «Too Many Requests…» | Se activó el límite general del servidor de KuCoin | Espere unos segundos y repita |
Cómo corregir los problemas frecuentes
El exchange rechazó la key
Coteje los tres campos
En Configuración → Conexiones, la conexión de KuCoin tiene tres campos: API Key, API Secret y Passphrase. Copie de nuevo la key y el secret, sin espacios en los extremos. La passphrase es la contraseña que definió al crear la API key, no la contraseña de acceso a KuCoin.
Verifique la key en el sitio web de KuCoin
Abra la administración de API en el perfil de KuCoin y compruebe que la key no esté eliminada. Si el secret o la passphrase no se guardaron, cree una key nueva: luego no se pueden consultar.
Verifique los permisos y la lista blanca de IP
La key debe tener permiso para operar en el mercado que esté activado en la conexión con los interruptores Spot y Futuros. Si la key tiene definida una lista blanca de IP, debe incluir su dirección externa o la dirección del proxy.
La etiqueta de key rechazada aparece una vez por conexión. Cuando la conexión se restablezca con la key corregida, el terminal podrá mostrarla de nuevo si la key vuelve a fallar.
Permisos y lista blanca de IP
Los códigos 400006 y 400007 significan que la key es correcta, pero el exchange no deja pasar la solicitud. Para 400006, agregue a la lista blanca de la key la IP externa de su equipo; si la conexión pasa por un proxy (sección Proxy en la tarjeta de la conexión), se agrega la dirección del proxy. Para 400007, active en la key el permiso para operar en el mercado correspondiente. Normalmente no hace falta volver a crear la key: los permisos y la lista de IP se modifican en la configuración de la key existente.
Fondos insuficientes
En spot (200004), el dinero bloqueado por órdenes abiertas no está disponible para una orden nueva. Cancele órdenes innecesarias o reduzca el volumen.
En futuros (300003), el dinero debe estar en la cuenta de futuros de KuCoin. Las cuentas spot y de futuros de KuCoin son independientes: transfiera fondos entre ellas en el sitio web del exchange.
Al cerrar una posición spot con una venta, la falta de fondos suele deberse a la comisión cobrada en la moneda comprada. El terminal lo tiene en cuenta: relee la wallet y repite la venta con un volumen un poco menor. Después puede quedar “polvo” en la wallet por debajo del paso de volumen, que no se puede vender con una orden.
Volumen en futuros
Las órdenes de futuros de KuCoin se expresan en contratos, no en monedas: cada contrato tiene su propio tamaño. El terminal convierte el volumen de monedas a contratos automáticamente y lo redondea al entero más cercano, pero nunca a menos de uno. Por eso, una orden menor a un contrato se enviará al exchange con volumen de un contrato: el volumen real será mayor que el ingresado. En cuentas pequeñas, verifique el tamaño del contrato de la moneda en el sitio web de KuCoin.
Límite de solicitudes superado
El terminal muestra la hora en UTC hasta la que rige la restricción y aplica la pausa por sí mismo. El límite se calcula por dirección: las conexiones de KuCoin a un mismo mercado a través de una misma IP o proxy consumen el cupo común. Si la restricción se repite, reduzca la cantidad de ventanas y paneles con KuCoin o separe las conexiones en proxies distintos. Más detalles en Mensajes del terminal.