Annonce de mise à jour de l'API de marge KuCoin

04/07/2025 14:33:02

Personnalisé

Chers utilisateurs de KuCoin,

Pour offrir aux utilisateurs un meilleur environnement de trading et optimiser l'expérience de trading, l'API d'effet de levier de KuCoin undergo une migration et une mise à niveau à haute fréquence. Cette migration sera effectuée par lots et devrait être terminée d'ici la fin mars 2026.

1. Portée de la migration :

Pour les utilisateurs ayant activé la marge, s'il n'y a aucune position ou actif en marge pendant la migration, cela ne vous affectera pas.

2. Impact de la migration :

     2.1 Utilisateurs non-API (utilisateurs finaux)

  • L'expérience utilisateur sur le Web/l'application restera inchangée avant et après la migration.

     2.2 Utilisateurs d'API

  • Cette migration aura un certain impact sur la méthode d'appel de l'interface API et sur l'affichage de l'état des actifs. Cette migration sera notifiée par lots. Veuillez effectuer les opérations correspondantes en temps utile après réception de la notification par e-mail. Le système effectuera la migration 7 jours après l'envoi de l'e-mail. (Pour réduire l'impact, vous pouvez passer à l'API haute fréquence à l'avance.)

3. Processus de migration :

Étape 1 : Nettoyez manuellement les ordres à faible fréquence

a. Les utilisateurs doivent annuler eux-mêmes les ordres passés via l'API à faible fréquence et l'interface C (Web/App) ;

b. Les ordres à haute fréquence n'ont pas besoin d'être annulés ;

  • Si vous ne l'annulez pas activement, le système annulera automatiquement la commande pendant le processus de migration (y compris les commandes ordinaires et avancées).

  • Si vous ne confirmez pas l'état de votre commande, veuillez contacter le service client pour obtenir de l'aide.

Étape 2 : Transférez manuellement les actifs à faible fréquence (utilisateurs API)

a. Les utilisateurs doivent transférer manuellement les actifs du compte à faible fréquence vers des comptes à haute fréquence et passer à la nouvelle interface API (voir api-doc pour plus de détails).

b. Obtenir les quotas de transfert - KUCOIN API À ce stade, les actifs de la partie C (site web et application) sont affichés comme « GELÉS », et les ordres à haute fréquence ne peuvent pas être exécutés.

Étape 3 : Démarrer la migration

Les étapes 1 et 2 ne sont pas obligatoires, mais une fois la migration effectuée, le système annulera automatiquement les ordres à faible fréquence et transférera les actifs à faible fréquence vers les comptes à haute fréquence.

Notes importantes :

  1. Compte temporairement indisponible (les utilisateurs C-end et les utilisateurs API seront affectés) ;

Pendant l'exécution de la migration, les comptes utilisateurs seront temporairement indisponibles pendant 2 à 3 minutes, ce qui concerne les fonctions de consultation d'actifs, de trading et de transfert. Veuillez planifier vos opérations à l'avance pour éviter de perturber vos transactions.

  1. Annulation forcée des ordres à faible fréquence ;

Si l'utilisateur n'annule pas la commande à faible fréquence à l'avance, le système annulera automatiquement les commandes ordinaires et avancées à faible fréquence non exécutées pendant le processus de migration.

  1. Les actifs sont affichés comme « gelés » pendant un court instant ;

Pendant la phase de préparation de la migration, les actifs à haute fréquence peuvent être affichés comme « gelés » dans l’ancienne interface et reprendront leur normalité une fois la migration terminée.

  1. Conseils de compatibilité d'interface ;

L'ancienne interface ne prendra plus en charge les requêtes fréquentes liées au compte. Assurez-vous de terminer le changement à l'avance, sinon une exception pourra être renvoyée.

  1. La migration officielle aura lieu 7 jours après la notification par e-mail ;

La migration officielle commencera 7 jours après l'envoi de l'e-mail de notification. Les utilisateurs sont invités à surveiller attentivement leurs boîtes de réception et à effectuer toutes les préparations nécessaires avant la date de migration afin d'assurer une transition fluide et d'éviter toute interruption de service.

Contenu de migration détaillé :

Requêtes sur les actifs

  •  Nous recommandons d'utiliser la nouvelle interface API pour les requêtes sur les actifs :

    • Requête d'actifs du compte sur marge croisée : /api/v3/margin/accounts

    • Requête d'actifs du compte sur marge isolée : /api/v3/isolated/accounts

  •  Après la migration, les données d'actifs avant et après la migration resteront cohérentes. Une fois la migration terminée, toutes les requêtes margin, margin_v2 et ALL retourneront des résultats cohérents (de même pour les comptes isolés).

Remarque : Les anciennes interfaces de requête d'actifs (/api/v1/margin/account pour la marge croisée et /v1/isolated/accounts pour la marge isolée) resteront disponibles après la migration, mais les actifs à haute fréquence seront affichés comme « Gelés » pour les utilisateurs qui n'ont pas encore migré.

Requêtes de registre de transactions

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

  • Le registre peut être interrogé pour les comptes à haute et basse fréquence avant et après la migration, avec la même plage horaire qu'auparavant.

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

  • Cela prend en charge uniquement la requête des transactions de compte à haute fréquence, avec une plage horaire limitée aux trois derniers jours.

Les utilisateurs peuvent choisir l'interface en fonction de leurs besoins.

Transferts

  •  L'interface de transfert reste identique. L'ancienne interface peut toujours être utilisée pour les transferts entre comptes à haute fréquence et à basse fréquence.

    • Avant la migration : les transferts entre comptes à haute fréquence et à basse fréquence au sein d'un même utilisateur sont pris en charge.

    • Après la migration : margin et margin_v2 seront traités comme le même compte, et les transferts entre ces deux comptes ne seront plus pris en charge (de même pour la marge isolée).

Requêtes de commandes historiques

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

  • Les ordres historiques peuvent être consultés pour les ordres à haute et basse fréquence, avec la même plage horaire.

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

  • Cela prend en charge uniquement la requête des ordres à haute fréquence et ne peut retourner des données que pour les trois derniers jours. Les utilisateurs peuvent choisir selon leurs besoins.

Passage de commande / Annulation de commande / Consultation des commandes actives

1. Interface V1 : prend en charge la passation, l'annulation et la consultation des ordres à faible fréquence actifs.

2. Interface V3 : prend en charge la passation, l'annulation et la consultation des ordres haute fréquence actifs.

Les ordres à haute fréquence et à basse fréquence ne sont pas compatibles entre eux, y compris les fonctions de prise de profit et de stop-loss. Les utilisateurs doivent utiliser l'interface correspondante en fonction du type d'ordre.

Changements de l'interface de migration :

  • Remarque : Il est recommandé de clarifier à l'avance les modifications de l'interface avant et après la migration afin d'éviter d'affecter l'utilisation.

Action

Avant l'interface de migration

Après l'interface de migration

Passation de commande

Commande régulière : /api/v1/margin/order

Ordre Stop : /api/v1/stop-order

Ordre régulier : /api/v3/hf/margin/order Ordre Stop : /api/v3/hf/margin/stop-order OCO : /api/v3/hf/margin/oco-order

Annulation de la commande

Par ID de commande : /api/v1/orders/{orderId}

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

Annulation en bloc : /api/v1/orders

Par ID de commande : /api/v3/hf/margin/orders/{orderId}?symbol={symbol}

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

Annulation en bloc : /api/v3/hf/margin/orders?symbol={symbol}&tradeType={tradeType}

Requête de commande active

/api/v1/orders?status=active

/api/v3/hf/margin/orders/active?tradeType={tradeType}&symbol={symbol} Interroger les paires de trading actives : /api/v3/hf/margin/order/active/symbols

Avertissement de risque

Le trading sur marge consiste à emprunter des fonds avec un montant de capital relativement faible pour négocier des actifs financiers et obtenir des profits plus importants. Toutefois, en raison des risques du marché, des fluctuations des prix et d'autres facteurs, il est fortement recommandé d'agir avec prudence dans vos investissements, d'adopter un niveau d'effet de levier approprié pour le trading sur marge et de limiter vos pertes en temps voulu. KuCoin ne assume aucune responsabilité pour les pertes résultant de la négociation.

Merci pour votre soutien !

L'équipe KuCoin

Découvrez la prochaine pépite crypto sur KuCoin !

Inscrivez-vous sur KuCoin dès maintenant ! >>>

Téléchargez l'application KuCoin >>>

Suivez-nous sur X (Twitter) >>>

Rejoignez-nous sur Telegram >>>

Rejoignez les communautés globales de KuCoin >>>

Avertissement : Pour votre confort, cette page a été traduite à l'aide de la technologie IA (GPT). Pour obtenir les informations à la source, consultez la version anglaise originale.