Wie kann ich die Positionsgröße von ETHUSDT-Futures anzeigen?

Zugriff auf Futures-Positionsdaten über die Binance REST API

1. Benutzer rufen die Positionsgröße von ETHUSDT Perpetual Futures in Echtzeit ab, indem sie den Endpunkt /fapi/v2/positionRisk mit gültigen API-Anmeldeinformationen und ordnungsgemäßer Signaturauthentifizierung aufrufen.

2. Die Anfrage muss den X-MBX-APIKEY- Header und einen Zeitstempelparameter enthalten, der innerhalb von ±60.000 Millisekunden der Binance-Serverzeit ausgerichtet ist, um eine Ablehnung zu vermeiden.

3. Eine signierte Abfragezeichenfolge mit dem Symbol=ETHUSDT und dem Zeitstempel wird mithilfe von HMAC-SHA256 mit dem geheimen Schlüssel des Benutzers generiert.

4. Die Antwortnutzlast gibt ein Array zurück, in dem jedes Objekt einer Position im Konto entspricht. Für ETHUSDT enthält der entsprechende Eintrag Felder wie positionAmt , enterPrice und unRealizedProfit .

5. Das Feld positionAmt gibt die Nettopositionsgröße in Kontrakten an, wobei positive Werte ein Long-Engagement und negative Werte ein Short-Engagement darstellen.

Interpretieren von Positionsbetrag und Vertragseinheiten

1. Bei ETHUSDT USD-M-Futures repräsentiert ein Kontrakt 0,01 ETH, was bedeutet, dass positionAmt = 100 einer Long-Position von 1 ETH entspricht.

2. Das Feld „notionalValue“ spiegelt die in USDT ausgedrückte Positionsgröße zum aktuellen Markpreis wider und ermöglicht so eine sofortige Bewertung ohne manuelle Umrechnung.

3. Die Leverage-Einstellungen verändern den Rohwert von positionAmt nicht, wirken sich jedoch direkt auf die Margin-Nutzung und die Liquidationsschwellen aus, die in derselben Antwort angezeigt werden.

4. Wenn im isolierten und im Cross-Margin-Modus mehrere Positionen vorhanden sind, wird jede als separates Array-Element mit unterschiedlichen Feldern „marginType“ und „isolatedMargin“ angezeigt.

5. Der Nullwert positionAmt bestätigt, dass für dieses Symbol keine offene Position besteht, unabhängig von der aktuellen Auftragshistorie oder ausstehenden Auslösern.

Verwendung von WebSocket-Streams für Echtzeit-Updates

1. Durch das Abonnieren des !account- Benutzerdatenstroms werden Positionsaktualisierungen sofort bei Ausführung, Liquidation oder Anpassung bereitgestellt – unter Umgehung der REST-Latenz.

2. Jede Nachricht enthält ein Positionsarray , dessen Struktur mit der REST-Antwort identisch ist, sodass eine direkte Zuordnung zum lokalen Status ohne Abfrage möglich ist.

3. Das updateTime- Feld in jedem Positionsobjekt enthält einen UNIX-Zeitstempel mit Millisekundengenauigkeit, der für die Synchronisierung mit Candlestick- oder Orderbuch-Streams von entscheidender Bedeutung ist.

4. WebSocket-Nachrichten enthalten auch crossWalletBalance und availableBalance und stellen neben der Positionsgröße auch kontextbezogene Margin-Gesundheit bereit.

5. Die Wiederverbindungslogik muss die Gültigkeit von listenKey bewahren. Das Versäumnis, alle 60 Minuten eine Aktualisierung durchzuführen, führt zur Beendigung des Streams und zum Verlust der Positionsdelta-Kontinuität.

Überlegungen zur clientseitigen Analyse und Anzeige

1. Frontend-Anwendungen, die Roh-JSON analysieren, müssen vor dem Rendern das Vorhandensein von positionAmt überprüfen, da fehlende Schlüssel entweder auf eine Nullposition oder einen Kontobereich mit eingeschränkten Berechtigungen hinweisen.

2. Die Verarbeitung mit Dezimalgenauigkeit ist obligatorisch: ETHUSDT verwendet 3 Dezimalstellen für positionAmt und Kürzungsfehler führen zu einer Fehlausrichtung zwischen der angezeigten Größe und der tatsächlichen Belichtung.

3. Das Sortieren des Positions-Arrays nach Symbol gewährleistet eine deterministische Rendering-Reihenfolge, wenn mehrere Symbole im selben Konto aktiv sind.

4. Leere oder Nullpositions -Arrays in WebSocket-Nutzlasten erfordern explizite UI-Fallbacks – ohne den Vergleich der Sequenznummern sollte keine Annahme „keine Änderung“ getroffen werden.

5. Farbcodierte Indikatoren – grün für positive positionAmt , rot für negativ – dürfen nur das Vorzeichen widerspiegeln, unabhängig vom Gewinn-/Verluststatus oder der Hebelwirkung.

Häufig gestellte Fragen

F: Warum zeigt positionAmt 0 an, auch nachdem eine Limit-Order aufgegeben wurde? Die Positionsgröße spiegelt nur erfüllte Kontrakte wider; Nicht ausgeführte Bestellungen werden unter openOrders angezeigt, nicht unter positions .

F: Kann ich die Positionsgröße für abgelaufene Lieferverträge anzeigen? Nein – in den Positionsantworten erscheinen nur aktiv gehandelte Symbole, die auf der aktuellen Notierung am Terminmarkt unterstützt werden; ausgelaufene Verträge sind gänzlich ausgeschlossen.

F: Beinhaltet positionAmt Positionen, die über API-Unterkonten gehalten werden? Nein – jeder API-Schlüssel greift nur auf sein eigenes Hauptkonto oder explizit delegiertes Unterkonto zu; Für die unterkontenübergreifende Aggregation sind separate authentifizierte Aufrufe pro Schlüssel erforderlich.

F: Ist positionAmt von Teilliquidationen betroffen? Ja – Teilliquidationen reduzieren positionAmt proportional und lösen eine sofortige WebSocket-Aktualisierung mit überarbeiteten Werten und aktualisiertem liquidationPrice aus.