KuCoin
Iniciar sesión
language_currency
Inicio
Anuncios
Anuncio de Actualización de la API de Margen de KuCoin

Anuncio de Actualización de la API de Margen de KuCoin

04/07/2025, 6:33:02

Imagen Personalizada

Estimados usuarios de KuCoin,

Para brindar a los usuarios un mejor entorno de trading y optimizar la experiencia de trading, la API de Margen de KuCoin está experimentando una migración y actualización de alta frecuencia.Esta migración se llevará a cabo en múltiples lotes y se espera que se complete para finales de 2025.

1. Alcance de la Migración:

Para los usuarios que tienen habilitado el Margen, si no existen posiciones o activos de Margen durante la migración, esta no les afectará.

2. Impacto de la Migración:

2.1 Usuarios No-API (usuarios finales)

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

2.2 Usuarios 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 será notificada en lotes. Por favor, realicen las operaciones correspondientes a tiempo tras recibir la notificación por correo electrónico. El sistema migrará 7 días después de que se envíe el correo. (Para reducir el impacto, pueden cambiar a la API de alta frecuencia con antelación).

3. Proceso de Migración:

Paso 1: Limpieza manual de órdenes de baja frecuencia

a. Los usuarios deben cancelar por sí mismos las órdenes colocadas mediante la API de baja frecuencia y los usuarios finales (Web/App);

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

  • Si no realizan la cancelación de manera activa, el sistema forzará la cancelación de las órdenes durante el proceso de migración (incluyendo órdenes ordinarias y avanzadas).

  • Si no confirman el estado de sus órdenes, por favor, contacten al servicio de atención al cliente para consultas.

Paso 2: Transferencia manual de activos de baja frecuencia (usuarios API)

a. Los usuarios deben transferir manualmente los activos de cuentas de baja frecuencia a cuentas de alta frecuencia y cambiar a la nueva interfaz API (consulten los detalles en api-doc).

b.Obtener Cuotas de Transferencia - API de KUCOINEn este momento, los activos en el C-end (Web y App) se muestran como "FROZEN", y no se pueden operar órdenes de alta frecuencia.

Paso 3: Iniciar la migración

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

Notas importantes:

  1. Indisponibilidad temporal de cuentas (tanto los usuarios de C-end como los usuarios de API se verán afectados);

Durante la ejecución de la migración, las cuentas de los usuarios estarán temporalmente indisponibles durante 2-3 minutos, afectando las funciones de consulta de activos, trading y transferencia. Por favor, organiza tus operaciones con antelación para evitar afectar las transacciones.

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

Si el usuario no cancela las órdenes de baja frecuencia previamente, el sistema cancelará de forma forzosa las órdenes ordinarias y avanzadas de baja frecuencia no cumplidas durante el proceso de migración.

  1. Los activos se muestran como "frozen" por un corto tiempo;

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

  1. Consejos de compatibilidad de la interfaz;

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

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

La migración oficial comenzará 7 días después del envío de la notificación por correo electrónico. Se recomienda a los usuarios monitorear 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 API para consultas de activos:

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

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

  • Después de la migración, los datos de activos anteriores y posteriores a la migración permanecerán consistentes. Una vez que se complete la migración, las consultas de margin, margin_v2 y ALL devolverán resultados consistentes (de manera similar para cuentas aisladas).

Nota:Las antiguas interfaces 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 serán mostrados como "Congelados" para los usuarios que no hayan completado la migración.

Consultas del Libro de Transacciones

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

  • El libro de transacciones se puede consultar tanto para cuentas de alta frecuencia como de baja frecuencia, antes y después de la migración, con el mismo rango de tiempo que anteriormente.

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

  • Solo admite la consulta de transacciones de cuentas 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 previa puede seguir utilizándose para transferencias entre cuentas de alta frecuencia 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: margen y margen_v2 serán tratados como la misma cuenta, y las transferencias entre estas dos cuentas ya no serán compatibles (de manera similar para el margen aislado).

Consultas de Órdenes Históricas

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

  • Las órdenes históricas se pueden consultar para órdenes de alta y baja frecuencia, con el mismo rango de tiempo.

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

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

Creación/Cancelación de Órdenes/Consulta de Órdenes Activas

1. V1 Interface: Admite la creación, cancelación y consulta de órdenes activas de baja frecuencia.

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

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

Cambios en las Interfaces por Migración:

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

Acción

Interfaz Antes de la Migración

Interfaz Después de la Migración

Creación de Órdenes

Orden Regular: /api/v1/margin/order

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

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

Cancelación de órdenes

Por orderId: /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} Consulta de pares de trading activos: /api/v3/hf/margin/order/active/symbols

Advertencia sobre riesgos

El trading de margen se refiere a la práctica de tomar préstamos de fondos con una cantidad de capital relativamente menor para operar activos financieros y obtener mayores beneficios. Sin embargo, debido a los riesgos del mercado, las fluctuaciones de precios y otros factores, se recomienda encarecidamente ser prudente con sus acciones de inversión, adoptar un nivel de apalancamiento adecuado para el trading de margen y detener sus pérdidas de manera oportuna.   KuCoin   no asume ninguna responsabilidad por las pérdidas derivadas del trading.

¡Gracias por su apoyo!

El equipo de KuCoin

¡Encuentra la próxima joya cripto en KuCoin!

Regístrate en KuCoin ahora >>>

Descarga la aplicación de KuCoin >>>

Síguenos en X (Twitter ) >>>

Únete a nuestro grupo 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.