Anuncio de actualización de la API de margen de KuCoin

04/07/2025 14:33:02

Personalizado

Estimados usuarios de KuCoin,

Para proporcionar a los usuarios un entorno de operación mejorado y optimizar la experiencia de trading, la API de apalancamiento de KuCoin está sometida a una migración y actualización de alta frecuencia. Esta migración se llevará a cabo en varios lotes y se espera que se complete a finales de marzo de 2026.

1. Alcance de la migración:

Para los usuarios que han habilitado el margen, si no hay posiciones ni activos de margen durante la migración, no le afectará.

2. Impacto de la migración:

     2.1 Usuarios no API (usuarios finales)

  • La experiencia del usuario en Web/App permanecerá igual antes y después de la migración.

     2.2 Usuarios de la API

  • Esta migración tendrá cierto impacto en el método de llamada de la interfaz API y en la visualización del estado de los activos. Esta migración se notificará por lotes. Realice las operaciones correspondientes a tiempo tras recibir la notificación por correo electrónico. El sistema realizará la migración 7 días después del envío del correo electrónico. (Para reducir el impacto, puede cambiar anticipadamente a la API de alta frecuencia).

3. Proceso de migración:

Paso 1: Limpieza manual de órdenes de baja frecuencia

a. Los usuarios deben cancelar ellos mismos las órdenes colocadas mediante API de baja frecuencia y C-end (Web/App);

b. Las órdenes de alta frecuencia no necesitan ser canceladas;

  • Si no cancelas activamente, el sistema cancelará automáticamente la orden durante el proceso de migración (incluyendo órdenes ordinarias y avanzadas).

  • Si no confirma el estado de su orden, póngase en contacto con el servicio al cliente para asesoramiento.

Paso 2: Realice manualmente la transferencia de activos de baja frecuencia (usuarios de API)

a. Los usuarios deben transferir manualmente los activos de la cuenta de baja frecuencia a cuentas de alta frecuencia y cambiar a la nueva interfaz API (consulte api-doc para más detalles).

b. Obtener cuotas de transferencia - KUCOIN API En este momento, los activos en el extremo C (web y aplicación) se muestran como "BLOQUEADOS", y no se pueden realizar órdenes de alta frecuencia.

Paso 3: Iniciar la migración

Los pasos 1 y 2 no son obligatorios, pero una vez ejecutada la migración, el sistema cancelará automáticamente los órdenes de baja frecuencia y transferirá los activos de baja frecuencia a cuentas de alta frecuencia.

Notas importantes:

  1. Disponibilidad temporal de la cuenta no disponible (afectará a los usuarios del lado C y a los usuarios de la API);

Durante la ejecución de la migración, las cuentas de usuario estarán temporalmente no disponibles durante 2-3 minutos, lo que afecta las funciones de consulta de activos, operaciones y transferencias. Por favor, planifique sus operaciones con anticipación para evitar afectar sus transacciones.

  1. Cancelación forzada de órdenes de baja frecuencia;

Si el usuario no cancela el orden de baja frecuencia con anticipación, el sistema cancelará automáticamente los órdenes ordinarias y avanzadas de baja frecuencia no cumplidas durante el proceso de migración.

  1. Los activos se muestran como "congelados" durante un breve período;

Durante la fase de preparación de la migración, los activos de alta frecuencia pueden aparecer como "congelados" en la interfaz antigua y volverán a la normalidad una vez completada la migración.

  1. Consejos de compatibilidad de interfaz;

La interfaz antigua ya no admitirá consultas relacionadas con la cuenta de alta frecuencia. Asegúrate de completar el cambio con anticipación, de lo contrario se podría devolver una excepción.

  1. La migración oficial se realizará 7 días después de la notificación por correo electrónico;

La migración oficial comenzará 7 días después de que se envíe la notificación por correo electrónico. Se recomienda a los usuarios supervisar atentamente sus bandejas de entrada y completar todos los preparativos necesarios antes de la fecha de migración para garantizar una transición fluida y evitar interrupciones en el servicio.

Contenido detallado de la migración:

Consultas de activos

  •  Recomendamos utilizar la nueva interfaz de API para consultas de activos:

    • Consulta de activos de la cuenta de margen cruzado: /api/v3/margin/accounts

    • Consulta de activos de la cuenta de margen aislado: /api/v3/isolated/accounts

  •  Después de la migración, los datos de activos antes y después de la migración permanecerán consistentes. Una vez completada la migración, todas las consultas de margen, margin_v2 y TODAS devolverán resultados consistentes (igualmente para las cuentas aisladas).

Nota: Las interfaces antiguas de consulta de activos (/api/v1/margin/account para margen cruzado y /v1/isolated/accounts para margen aislado) seguirán disponibles después de la migración, pero los activos de alta frecuencia se mostrarán como "Congelados" para los usuarios que aún no han migrado.

Consultas del libro de transacciones

1. Interfaz V1: /api/v1/accounts/ledgers

  • El libro mayor puede consultarse para cuentas de alta y baja frecuencia antes y después de la migración, con el mismo rango de tiempo que antes.

2. Interfaz V3: /api/v3/hf/margin/account/ledgers

  • Esto solo admite consultar transacciones de cuenta de alta frecuencia, con un rango de tiempo limitado a los últimos tres días.

Los usuarios pueden elegir la interfaz según sus necesidades.

Transferencias

  •  La interfaz de transferencia permanece igual. La interfaz anterior aún puede usarse para transferencias entre cuentas de alta y baja frecuencia.

    • Antes de la migración: Se admiten transferencias entre cuentas de alta y baja frecuencia dentro del mismo usuario.

    • Después de la migración: margin y margin_v2 se tratarán como la misma cuenta, y las transferencias entre estas dos cuentas ya no serán compatibles (igualmente para el margen aislado).

Consultas de órdenes históricas

1. Interfaz V1: /api/v1/orders?status=done

  • Los órdenes históricos pueden consultarse para órdenes de alta y baja frecuencia, con el mismo rango de tiempo.

2. Interfaz V3: /api/v3/hf/margin/orders/done

  • Solo admite consultar órdenes de alta frecuencia y solo puede devolver datos de los últimos tres días. Los usuarios pueden elegir según sus necesidades.

Colocación de orden / Cancelación de orden / Consulta de órdenes activas

1. Interfaz V1: Admite colocar, cancelar y consultar órdenes activas de baja frecuencia.

2. Interfaz V3: Admite la colocación, cancelación y consulta de órdenes de alta frecuencia activas.

Las órdenes de alta y baja frecuencia no son compatibles entre sí, incluyendo las funciones de toma de ganancias y pérdida stop. Los usuarios deben utilizar la interfaz correspondiente según el tipo de orden.

Cambios en la interfaz de migración:

  • Nota: Se recomienda aclarar los cambios en la interfaz involucrados antes y después de la migración con anticipación para evitar afectar el uso.

Acción

Antes de la interfaz de migración

Después de la interfaz de migración

Colocación de orden

Orden regular: /api/v1/margin/order

Orden de stop: /api/v1/stop-order

Orden regular: /api/v3/hf/margin/order Orden de stop: /api/v3/hf/margin/stop-order OCO: /api/v3/hf/margin/oco-order

Cancelación de orden

Por ID de orden: /api/v1/orders/{orderId}

Por clientOid: /api/v1/order/client-order/{clientOid}

Cancelación masiva: /api/v1/orders

Por orderId: /api/v3/hf/margin/orders/{orderId}?symbol={symbol}

Por clientOid: /api/v3/hf/margin/orders/client-order/{clientOid}?symbol={symbol}

Cancelación masiva: /api/v3/hf/margin/orders?symbol={symbol}&tradeType={tradeType}

Consulta de órdenes activas

/api/v1/orders?status=active

/api/v3/hf/margin/orders/active?tradeType={tradeType}&symbol={symbol} Consultar pares de trading activos: /api/v3/hf/margin/order/active/symbols

Advertencia de riesgo

El trading de márgenes se refiere a la práctica de tomar prestados fondos con una cantidad relativamente menor de capital para operar con activos financieros y obtener mayores beneficios. Sin embargo, debido a los riesgos del mercado, las fluctuaciones de precios y otros factores, se recomienda encarecidamente que sea prudente en sus acciones de inversión, adopte un nivel de apalancamiento adecuado para el trading de márgenes y cierre oportunamente sus pérdidas. KuCoin no asume ninguna responsabilidad por las pérdidas derivadas de la operación.

¡Gracias por tu apoyo!

El equipo de KuCoin

¡Encuentra la próxima joya cripto en KuCoin!

¡Regístrate en KuCoin ahora! >>>

Descarga la aplicación KuCoin >>>

Síguenos en X (Twitter) >>>

Únete a nosotros en Telegram >>>

Únete a las comunidades globales 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.