Comment afficher la taille de la position à terme ETHUSDT ?

Accéder aux données de position à terme via l'API REST Binance

1. Les utilisateurs récupèrent la taille de la position à terme perpétuelle ETHUSDT en temps réel en appelant le point de terminaison /fapi/v2/positionRisk avec des informations d'identification API valides et une authentification de signature appropriée.

2. La demande doit inclure l'en-tête X-MBX-APIKEY et un paramètre d'horodatage aligné à ± 60 000 millisecondes de l'heure du serveur Binance pour éviter le rejet.

3. Une chaîne de requête signée contenant le symbole = ETHUSDT et l'horodatage est générée à l'aide de HMAC-SHA256 avec la clé secrète de l'utilisateur.

4. La charge utile de la réponse renvoie un tableau dans lequel chaque objet correspond à une position dans le compte ; pour ETHUSDT, l'entrée correspondante contient des champs tels que positionAmt , EntryPrice et unRealizedProfit .

5. Le champ positionAmt indique la taille nette de la position dans les contrats, avec des valeurs positives représentant une exposition longue et des valeurs négatives indiquant une exposition courte.

Interprétation du montant de la position et des unités du contrat

1. Pour les contrats à terme ETHUSDT USD-M, un contrat représente 0,01 ETH, ce qui signifie que positionAmt = 100 équivaut à une position longue de 1 ETH.

2. Le champ notionalValue reflète la taille de la position exprimée en USDT au prix actuel, permettant une évaluation immédiate sans conversion manuelle.

3. Les paramètres d'effet de levier ne modifient pas la valeur brute de la positionAmt mais affectent directement l'utilisation de la marge et les seuils de liquidation indiqués dans la même réponse.

4. S'il existe plusieurs positions dans les modes isolé et marge croisée, chacune apparaît comme un élément de tableau distinct avec des champs marginType et isolatedMargin distincts.

5. PositionAmt de valeur zéro confirme aucune position ouverte pour ce symbole, quel que soit l'historique des commandes récentes ou les déclencheurs en attente.

Utilisation de WebSocket Streams pour les mises à jour en temps réel

1. L'abonnement au flux de données utilisateur !account fournit des mises à jour de position instantanément lors de l'exécution, de la liquidation ou de l'ajustement, en contournant la latence REST.

2. Chaque message comprend un tableau de positions de structure identique à la réponse REST, permettant un mappage direct vers l'état local sans interrogation.

3. Le champ updateTime à l'intérieur de chaque objet de position comporte un horodatage UNIX de précision à la milliseconde, essentiel pour la synchronisation avec les flux de chandeliers ou de carnets d'ordres.

4. Les messages WebSocket contiennent également crossWalletBalance et availableBalance , fournissant l'état de la marge contextuelle ainsi que la taille de la position.

5. La logique de reconnexion doit préserver la validité de ListenKey ; le fait de ne pas actualiser toutes les 60 minutes entraîne l'arrêt du flux et la perte de continuité du delta de position.

Considérations sur l’analyse et l’affichage côté client

1. Les applications frontales analysant le JSON brut doivent valider la présence de positionAmt avant le rendu, car les clés manquantes indiquent soit une position nulle, soit une portée de compte restreinte par les autorisations.

2. La gestion de la précision décimale est obligatoire : ETHUSDT utilise 3 décimales pour positionAmt , et les erreurs de troncature provoquent un désalignement entre la taille affichée et l'exposition réelle.

3. Le tri du tableau de positions par symbole garantit un ordre de rendu déterministe lorsque plusieurs symboles sont actifs dans le même compte.

4. Les tableaux de positions vides ou nulles dans les charges utiles WebSocket nécessitent des solutions de repli explicites de l'interface utilisateur : aucune hypothèse de « aucun changement » ne doit être faite sans comparer les numéros de séquence.

5. Les indicateurs à code couleur (vert pour une position positive, rouge pour une position négative) doivent refléter uniquement le signe, indépendamment du statut de profit/perte ou du niveau de levier.

Foire aux questions

Q : Pourquoi positionAmt affiche-t-il 0 même après avoir passé un ordre limité ? La taille des positions reflète uniquement les contrats exécutés ; les commandes non exécutées apparaissent sous openOrders , pas sous positions .

Q : Puis-je afficher la taille des positions pour les contrats de livraison expirés ? Non : seuls les symboles activement négociés pris en charge sur la cotation actuelle du marché à terme apparaissent dans les réponses de position ; les contrats expirés sont entièrement exclus.

Q : Est-ce que positionAmt inclut les positions détenues via les sous-comptes API ? Non : chaque clé API accède uniquement à son propre compte principal ou à un sous-compte explicitement délégué ; L'agrégation entre sous-comptes nécessite des appels authentifiés distincts par clé.

Q : La positionAmt est-elle affectée par les liquidations partielles ? Oui : les liquidations partielles réduisent positionAmt proportionnellement et déclenchent une mise à jour immédiate de WebSocket avec des valeurs révisées et une liquidationPrice mise à jour.