Comment ajuster la marge à terme BTCUSDT sans clôturer la position ?

Mécanismes de commutation de mode de marge

1. Les utilisateurs peuvent basculer entre les modes de marge isolée et croisée pour les contrats perpétuels BTCUSDT sans liquider les positions ouvertes. Cette opération modifie la manière dont la marge est allouée mais ne déclenche aucune exécution d'ordre.

2. Le point de terminaison de l'API Binance Futures /fapi/v1/marginType accepte les requêtes POST avec les paramètres de symbole, marginType (ISOLATED ou CROSS) et d'horodatage. Une réponse réussie ne renvoie aucune charge utile mais confirme le changement de mode via le statut HTTP 200.

3. Lors du passage du mode croisé au mode isolé, le système alloue automatiquement une marge initiale en fonction de la taille actuelle de la position et du paramètre d'effet de levier. Aucun complément de marge manuel n'est requis à ce stade, sauf si la marge de maintien tombe en dessous du seuil.

4. Les ajustements de marge isolés nécessitent l'utilisation explicite de /fapi/v1/positionMargin , où les utilisateurs spécifient le montant, le type (0 pour ajouter, 1 pour réduire) et le côté de position. Cet appel modifie directement le solde de marge lié à cette position spécifique.

Modification de la marge au niveau de la position

1. La réduction de la marge isolée n'est autorisée que lorsque le taux de marge de maintenance qui en résulte reste supérieur à 100 %. L'API rejette les demandes qui entraîneraient une liquidation immédiate ou dépasseraient les seuils définis par la bourse.

2. L'ajout d'une marge à une position isolée augmente proportionnellement la distance du prix de liquidation. Pour les positions longues, une marge plus élevée fait baisser le prix de liquidation ; pour les shorts, cela augmente le prix de liquidation.

3. Chaque ajustement de marge déclenche un recalcul en temps réel de l'effet de levier de la position. Le nouvel effet de levier efficace apparaît instantanément dans les panneaux de présentation du compte et de détails de la position.

4. Les ajouts de marge s'exécutent de manière synchrone par rapport au solde du portefeuille. Si l'USDT disponible dans le portefeuille à terme est insuffisant, la demande échoue avec le code d'erreur -4046 indiquant « Solde de marge insuffisant ».

Contraintes des paramètres de l'API

1. Le champ de montant dans les demandes positionMargin doit être exprimé en unités monétaires de cotation (USDT) et ne peut pas contenir de décimales au-delà de deux chiffres.

2. Les valeurs de levier transmises à /fapi/v1/leverage doivent se situer dans les plages spécifiées par la bourse : 1 à 125x pour les contrats trimestriels BTCUSDT, 1 à 75x pour les contrats perpétuels dans des conditions normales de marché.

3. Le paramètre d'horodatage doit se situer à ± 60 secondes de l'heure du serveur. Les requêtes avec des horodatages asymétriques renvoient le code d’erreur -1021 et sont carrément rejetées.

4. Toutes les demandes signées nécessitent une signature HMAC-SHA256 calculée sur une chaîne de requête concaténée à l'aide de la clé secrète de l'utilisateur. Les signatures invalides génèrent le code d'erreur -1022.

Transparence du calcul des risques

1. Les mises à jour des prix de liquidation apparaissent immédiatement après la modification de la marge dans les données de position renvoyées par /fapi/v2/positionRisk . Ce point de terminaison fournit des valeurs en temps réel, notamment le prix d'entrée, le prix de référence, le PnL non réalisé et le taux de marge de maintenance.

2. La marge de maintenance est calculée comme la valeur de la position multipliée par le taux de marge de maintenance, qui varie en fonction du niveau d'effet de levier et de la taille de la position. Pour les positions BTCUSDT supérieures à 50 équivalents BTC, le taux passe de 0,5 % à 1,5 %.

3. Les PnL non réalisés ont un impact dynamique sur la marge disponible. Un PnL négatif réduit la marge disponible tandis qu'un PnL positif l'augmente, affectant continuellement les calculs du ratio de marge.

4. Les changements de marge de position n'affectent pas l'accumulation du taux de financement ou les intervalles de règlement. Les paiements de financement se poursuivent conformément aux conditions contractuelles initiales, quels que soient les ajustements de marge.

Scénarios de dépannage courants

1. Q : Pourquoi la réduction de la marge échoue-t-elle même lorsque la position présente des capitaux propres positifs ? R : Le système impose des exigences de marge minimale en fonction du prix actuel et de la taille de la position. Les PnL positifs non réalisés ne remplacent pas les seuils de maintenance imposés par la bourse.

2. Q : Puis-je ajuster la marge pendant qu'un ordre stop-market est actif sur la même position ? R : Oui. Les modifications de marge fonctionnent indépendamment des ordres en attente. Cependant, si l'ordre stop est exécuté et déclenche la fermeture de la position, les ajustements de marge ultérieurs deviennent invalides.

3. Q : Le changement de mode de marge réinitialise-t-il le prix d'entrée ou le coût moyen de ma position ? R : Non. Le prix d’entrée, les frais accumulés et le PnL réalisé restent inchangés. Seules la méthodologie d'allocation de la marge et les paramètres de liquidation sont recalculés.

4. Q : Qu'arrive-t-il aux ordres à cours limité ouverts lorsque je passe d'un ordre croisé à un ordre à marge isolée ? R : Les ordres limités restent actifs mais leur impact sur la marge change. En mode isolé, ils tirent une marge exclusivement du solde de marge de la position désignée plutôt que du portefeuille croisé partagé.