Annonce de mise à niveau de l'API Marge de KuCoin

Annonce de mise à niveau de l'API Marge de KuCoin

04/07/2025 06:33:02

Image personnalisée

Chers utilisateurs de KuCoin,

Afin d'offrir aux utilisateurs un meilleur environnement de trading et d'optimiser leur expérience de trading, l'API Marge de KuCoin fait l'objet d'une migration et d'une mise à niveau en haute fréquence.Cette migration sera effectuée en plusieurs phases et devrait être terminée d'ici la fin de l'année 2025.

1. Portée de la migration :

Pour les utilisateurs ayant activé la marge, si aucune position ou aucun actif en marge n'est détenu pendant la migration, cela ne vous impactera pas.

2. Impact de la migration :

2.1 Utilisateurs non-API (utilisateurs finaux)

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

2.2 Utilisateurs API

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

3. Processus de migration :

Étape 1 : Nettoyer manuellement les ordres en basse fréquence

a. Les utilisateurs doivent annuler eux-mêmes les ordres placés via l’API basse fréquence et le C-end (Web/App);

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

  • Si vous n'annulez pas de manière proactive, le système forcera l'annulation de l'ordre pendant le processus de migration (y compris les ordres ordinaires et avancés).

  • Si vous ne confirmez pas l'état de vos ordres, veuillez contacter le service client pour une consultation.

Étape 2 : Transférer manuellement les actifs en basse fréquence (utilisateurs API)

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

b.Obtenez des quotas de transfert - KUCOIN APIÀ ce jour, les actifs sur l'interface C (Web et App) sont affichés comme « GELÉS », et les ordres à haute fréquence ne peuvent pas être exécutés.

Étape 3 : Début de la migration

*Les étapes 1 et 2 ne sont pas obligatoires, mais une fois la migration exécuté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.

Remarques importantes :

  1. Indisponibilité temporaire des comptes (les utilisateurs de l'interface C et les utilisateurs API seront affectés) ;

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

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

Si l'utilisateur n'annule pas les ordres à faible fréquence en amont, le système annulera de manière forcée les ordres ordinaires non exécutés et les ordres avancés à faible fréquence au cours du processus de migration.

  1. Les actifs sont affichés comme « gelés » pendant une courte période ;

Pendant la phase de préparation à la migration, les actifs haute fréquence peuvent être affichés comme « gelés » dans l'ancienne interface. Ils reviendront à la normale après la fin de la migration.

  1. Conseils sur la compatibilité des interfaces ;

L'ancienne interface ne prendra plus en charge les requêtes liées aux comptes haute fréquence. Assurez-vous de compléter la transition à l'avance, faute de quoi une exception pourrait être retournée.

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

La migration officielle commencera 7 jours après l'envoi de la notification par email. Les utilisateurs sont invités à surveiller attentivement leur boîte de réception et à effectuer toutes les préparations nécessaires avant la date de migration pour garantir une transition fluide et éviter toute interruption de service.

Contenu détaillé de la migration :

Requêtes sur les actifs

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

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

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

  • Après la migration, les données des actifs avant et après la migration resteront cohérentes. Une fois la migration terminée, les requêtes concernant les marges, marge_v2 et TOUTES renverront des résultats cohérents (de même pour les comptes isolés).

Remarque : Les anciennes interfaces de requêtes 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 du Registre de Transactions

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

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

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

  • Cette interface ne prend en charge que les requêtes de transactions des comptes à haute fréquence, avec une plage de temps limitée aux trois derniers jours.

Les utilisateurs peuvent choisir l'interface selon leurs besoins.

Transferts

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

    • Avant 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 migration : margin et margin_v2 seront traités comme un seul et 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 d'Ordres Historiques

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

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

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

  • Cette interface ne prend en charge que les requêtes d'ordres à haute fréquence et ne peut retourner des données que pour les trois derniers jours. Les utilisateurs peuvent choisir selon leurs besoins.

Placement d'Ordres/Annulation d'Ordres/Requête d'Ordres Actifs

1. V1 Interface : Prend en charge le placement, l'annulation et la requête des ordres actifs à basse fréquence.

2. V3 Interface : Prend en charge le placement, l'annulation et la requête des ordres actifs à haute fréquence.

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

Modifications des Interfaces de Migration :

  • Remarque : Il est recommandé de clarifier à l'avance les changements d'interface impliqués avant et après la migration afin d’éviter tout impact sur l’utilisation.

Action

Interface Avant Migration

Interface Après Migration

Placement d'Ordres

Ordre Régulier : /api/v1/margin/order

Ordre Stop : /api/v1/stop-order

Commande régulière : /api/v3/hf/margin/order Commande Stop : /api/v3/hf/margin/stop-order OCO : /api/v3/hf/margin/oco-order

Annulation de commande

Par orderId : /api/v1/orders/{orderId}

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

Annulation en masse : /api/v1/orders

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

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

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

Consultation des commandes actives

/api/v1/orders?status=active

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


Avertissement sur les risques

Le trading sur marge désigne la pratique consistant à emprunter des fonds avec un montant de capital relativement réduit afin de trader des actifs financiers et d'obtenir des profits plus importants. Cependant, en raison des risques de marché, des fluctuations de prix et d'autres facteurs, il est fortement recommandé d'être prudent dans vos actions d'investissement, d'adopter un niveau d'effet de levier approprié pour le trading sur marge, et de stopper vos pertes de manière appropriée et en temps opportun.   KuCoin   n'assume aucune responsabilité pour les pertes découlant des transactions.

Merci pour votre soutien !

L'équipe KuCoin

Trouvez la prochaine crypto-pépite 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 mondiales 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.