Anuncio de la actualización de la API de KuCoin (2026-06-03)

Para mejorar la experiencia de trading de API, potenciar las capacidades de trading bajo el marco de la Cuenta de Trading Unificada (UTA) y reducir la complejidad de integración entre diferentes modos de cuenta, KuCoin actualizará la API Pro y lanzará actualizaciones relacionadas de la API.
Después de la actualización, la API Pro se actualizará a la API UTA. A partir de ahora, la API UTA solo admitirá el modo Unified Trading Account (UTA).
 

1. Programa de actualización

La actualización está programada para las 08:00 del 3 de junio de 2026 (UTC) y se espera que dure 180 minutos.
 

2. Impacto de la actualización

Durante el período de actualización, los usuarios pueden experimentar los siguientes impactos:
  1. El WebSocket PRO puede experimentar desconexiones temporales, pérdida de datos o retrasos. Los usuarios pueden reconectarse al WebSocket para restaurar la conexión.
 

3. Detalles de la actualización

3.1 Actualización de la API UTA

Actualmente, ciertos puntos finales de la API Pro son compatibles con tanto Cuentas Clásicas como Cuentas de Trading Unificadas (UTA). En el futuro, continuaremos enfocándonos en el marco de la Cuenta de Trading Unificada y mejoraremos aún más la API de UTA con nuevas funcionalidades y optimizaciones de características. El soporte de compatibilidad relacionado con las Cuentas Clásicas entrará en modo de mantenimiento y ya no será el enfoque principal para el desarrollo de nuevas funciones, mejoras de rendimiento o la evolución a largo plazo de la plataforma.
 
[Detalles del ajuste]
  • La API Pro se actualizará a la API UTA, que dará soporte principalmente a la Cuenta de Trading Unificada (UTA) a partir de ahora.
  • El soporte de compatibilidad relacionado con la Cuenta Clásica dentro de la API UTA entrará en modo de mantenimiento.
 
Si actualmente estás utilizando el modelo “Pro API + Cuenta Clásica”, te recomendamos encarecidamente completar una de las siguientes opciones de migración lo antes posible:
  • Cambia al modo de cuenta de trading unificada (UTA) para operar;
  • Continúa utilizando la API Clásica para operar con la Cuenta Clásica.
 
Esto ayudará a garantizar una migración fluida y operaciones de comercio ininterrumpidas.
 

3.2 Actualizaciones de la API

  • Optimización del handshake y el flujo de autenticación de WebSocket:
    • El procesamiento sincrónico se cambiará a procesamiento asincrónico durante las etapas de handshake y autenticación, reduciendo el comportamiento de bloqueo y mejorando la cantidad de solicitudes de autenticación que se pueden procesar por unidad de tiempo.
    • Cuando una conexión WebSocket falla en la autenticación debido a credenciales inválidas, expiradas o no autorizadas, el servidor enviará un mensaje “auth failed” a través de un marco WebSocket, permitiendo a los clientes identificar rápidamente la razón del fallo y tomar las acciones adecuadas. Esta optimización no afecta las conexiones WebSocket autenticadas correctamente.

 

    • positionMargin: Margen ocupado por la posición de futuros.
    • riskRatio: Relación de riesgo de una posición de futuros aislada.

 

  • [Modificar] UTA Websocket Position, campo de respuesta añadido:
    • pM: Margen ocupado por la posición de futuros.
    • r: Relación de riesgo de una posición de futuros aislada. Por ejemplo, 0.65 representa el 65%.

 

  • [Modificar] Classic REST Obtener lista de depósitos y Classic REST Obtener detalle del depósito. Los puntos finales han añadido los siguientes valores de estado para mostrar estados de depósito más detallados:
    • ROLLBACKING: Reversando el depósito. Por favor, espere.
    • RETROCESO: Depósito revertido. No se han acreditado fondos a la cuenta. Contáctese con soporte para obtener ayuda.
    • WAIT_RISK_MGT: El depósito está sometido a verificación de riesgo estándar. Contáctese con soporte para obtener ayuda.
    • RISK_MGT_REJECTED: El depósito fue rechazado tras la verificación de riesgo. Contáctanos para enviar la información requerida para su revisión.
    • PRE_SUCCESS: Los fondos han sido acreditados en la cuenta antes de la confirmación final del bloque.
    • WAIT_TRM_MGT: El depósito está en proceso de verificación de cumplimiento estándar. Por favor, contacta al soporte para obtener ayuda.
    • TRM_MGT_REJECTED : El depósito fue rechazado tras la verificación de riesgo. Por favor, contacta al soporte para enviar la información requerida para su revisión.

 

  • [Añadir] Fast API - Aplicar para retiro rápido
    • Admite permisos de clave de API definidos por el usuario en el flujo de autorización OAuth, incluyendo la concesión de permisos de retiro
    • Nuevo permiso: Retiro rápido (permiso de retiro rápido mediante API)
    • Soportar retiros mediante API con verificación de autenticación de dos factores

 

 

 

  • [Modificar] UTA REST Place Order, agregar nuevo campo closeOrder para admitir el cierre de posición para el símbolo especificado

 

  • [Modificar] UTA REST Obtener cuotas de transferencia, agregar nuevo enum UNIFIED en el campo accountType en los parámetros de consulta y los parámetros de respuesta
 
 
Para obtener más información sobre la API, únete a la comunidad oficial de Telegram de KuCoin API
También puedes contactarnos por correo electrónico en: api@kucoin.com
 
Lamentamos sinceramente cualquier inconveniente que este ajuste pueda causar y agradecemos su continuo apoyo y confianza en la API de KuCoin.

Aviso: Esta página fue traducida utilizando tecnología de IA (impulsada por GPT) para tu conveniencia. Para obtener la información más precisa, consulta la versión original en inglés.