Was macht Binance Derivate-Handel-Portfolio-Margin-Skill?
Ermöglicht Portfolio-Margin-Anfragen für den Derivatehandel auf Binance mithilfe authentifizierter API-Endpunkte. Erfordert API-Key und Secret-Key für bestimmte Endpunkte. Gibt das Ergebnis im JSON-Format zurück.
Kurzreferenz
| Endpunkt | Beschreibung | Erforderlich | Optional | Authentifizierung |
|---|---|---|---|---|
/papi/v1/balance (GET) | Kontostand (USER_DATA) | Keine | asset, recvWindow | Ja |
/papi/v1/account (GET) | Kontoinformationen (USER_DATA) | Keine | recvWindow | Ja |
/papi/v1/bnb-transfer (POST) | BNB-Transfer (TRADE) | amount, transferSide | recvWindow | Ja |
/papi/v1/cm/leverageBracket (GET) | CM Nominal- und Hebelklassen (USER_DATA) | Keine | symbol, recvWindow | Ja |
/papi/v1/repay-futures-switch (POST) | Auto-Repay-Futures-Status ändern (TRADE) | autoRepay | recvWindow | Ja |
/papi/v1/repay-futures-switch (GET) | Auto-Repay-Futures-Status abrufen (USER_DATA) | Keine | recvWindow | Ja |
/papi/v1/cm/leverage (POST) | CM Initialen Hebel ändern (TRADE) | symbol, leverage | recvWindow | Ja |
/papi/v1/cm/positionSide/dual (POST) | CM-Positionsmodus ändern (TRADE) | dualSidePosition | recvWindow | Ja |
/papi/v1/cm/positionSide/dual (GET) | CM-Aktuellen Positionsmodus abrufen (USER_DATA) | Keine | recvWindow | Ja |
/papi/v1/um/leverage (POST) | UM Initialen Hebel ändern (TRADE) | symbol, leverage | recvWindow | Ja |
/papi/v1/um/positionSide/dual (POST) | UM-Positionsmodus ändern (TRADE) | dualSidePosition | recvWindow | Ja |
/papi/v1/um/positionSide/dual (GET) | UM-Aktuellen Positionsmodus abrufen (USER_DATA) | Keine | recvWindow | Ja |
/papi/v1/auto-collection (POST) | Automatische Mittel-Einsammlung (Fund Auto-collection) (TRADE) | Keine | recvWindow | Ja |
/papi/v1/asset-collection (POST) | Mittel-Einsammlung nach Asset (TRADE) | asset | recvWindow | Ja |
/papi/v1/cm/account (GET) | CM-Kontodetails abrufen (USER_DATA) | Keine | recvWindow | Ja |
/papi/v1/cm/income (GET) | CM-Einkommenshistorie abrufen (USER_DATA) | Keine | symbol, incomeType, startTime, endTime, page, limit, recvWindow | Ja |
/papi/v1/um/order/asyn (GET) | Download-ID für UM-Futures-Orderhistorie abrufen (USER_DATA) | startTime, endTime | recvWindow | Ja |
/papi/v1/um/trade/asyn (GET) | Download-ID für UM-Futures-Tradehistorie abrufen (USER_DATA) | startTime, endTime | recvWindow | Ja |
/papi/v1/um/income/asyn (GET) | Download-ID für UM-Futures-Transaktionshistorie abrufen (USER_DATA) | startTime, endTime | recvWindow | Ja |
/papi/v1/margin/marginInterestHistory (GET) | Margin-Kredit-/Darlehenszinshistorie abrufen (USER_DATA) | Keine | asset, startTime, endTime, current, size, archived, recvWindow | Ja |
/papi/v2/um/account (GET) | UM-Kontodetails V2 abrufen (USER_DATA) | Keine | recvWindow | Ja |
/papi/v1/um/account (GET) | UM-Kontodetails abrufen (USER_DATA) | Keine | recvWindow | Ja |
/papi/v1/um/accountConfig (GET) | UM-Futures-Kontokonfiguration (USER_DATA) | Keine | recvWindow | Ja |
/papi/v1/um/order/asyn/id (GET) | UM-Futures-Order-Download-Link anhand der ID abrufen (USER_DATA) | downloadId | recvWindow | Ja |
/papi/v1/um/symbolConfig (GET) | UM-Futures-Symbolkonfiguration (USER_DATA) | Keine | symbol, recvWindow | Ja |
/papi/v1/um/trade/asyn/id (GET) | UM-Futures-Trade-Download-Link anhand der ID abrufen (USER_DATA) | downloadId | recvWindow | Ja |
/papi/v1/um/income/asyn/id (GET) | UM-Futures-Transaktions-Download-Link anhand der ID abrufen (USER_DATA) | downloadId | recvWindow | Ja |
/papi/v1/um/income (GET) | UM-Einkommenshistorie abrufen (USER_DATA) | Keine | symbol, incomeType, startTime, endTime, page, limit, recvWindow | Ja |
/papi/v1/cm/commissionRate (GET) | Nutzer-Provisionstarif für CM abrufen (USER_DATA) | symbol | recvWindow | Ja |
/papi/v1/um/commissionRate (GET) | Nutzer-Provisionstarif für UM abrufen (USER_DATA) | symbol | recvWindow | Ja |
/papi/v1/margin/maxBorrowable (GET) | Maximaler Margin-Kredit (Margin Max Borrow) (USER_DATA) | asset | recvWindow | Ja |
/papi/v1/um/apiTradingStatus (GET) | Portfolio Margin UM Trading Quantitative Rules Indicators (USER_DATA) | Keine | symbol, recvWindow | Ja |
/papi/v1/cm/positionRisk (GET) | CM-Positionsinformationen abfragen (USER_DATA) | Keine | marginAsset, pair, recvWindow | Ja |
/papi/v1/margin/marginLoan (GET) | Margin-Kredit-Datensatz abfragen (USER_DATA) | asset | txId, startTime, endTime, current, size, archived, recvWindow | Ja |
/papi/v1/margin/maxWithdraw (GET) | Maximalen Margin-Abzug abfragen (USER_DATA) | asset | recvWindow | Ja |
/papi/v1/margin/repayLoan (GET) | Margin-Rückzahlungsdatensatz abfragen (USER_DATA) | asset | txId, startTime, endTime, current, size, archived, recvWindow | Ja |
/papi/v1/portfolio/interest-history (GET) | Portfolio-Margin-Negativsaldo-Zinshistorie abfragen (USER_DATA) | Keine | asset, startTime, endTime, size, recvWindow | Ja |
/papi/v1/um/positionRisk (GET) | UM-Positionsinformationen abfragen (USER_DATA) | Keine | symbol, recvWindow | Ja |
/papi/v1/portfolio/negative-balance-exchange-record (GET) | Negativsaldo-Autotausch-Datensatz des Nutzers abfragen (USER_DATA) | startTime, endTime | recvWindow | Ja |
/papi/v1/rateLimit/order (GET) | Nutzer-Ratenlimit abfragen (USER_DATA) | Keine | recvWindow | Ja |
/papi/v1/repay-futures-negative-balance (POST) | Futures-Negativsaldo zurückzahlen (USER_DATA) | Keine | recvWindow | Ja |
/papi/v1/um/leverageBracket (GET) | UM Nominal- und Hebelklassen (USER_DATA) | Keine | symbol, recvWindow | Ja |
/papi/v1/ping (GET) | Konnektivität testen | Keine | Keine | Nein |
/papi/v1/cm/userTrades (GET) | CM-Konto-Tradeliste (USER_DATA) | Keine | symbol, pair, startTime, endTime, fromId, limit, recvWindow | Ja |
/papi/v1/cm/adlQuantile (GET) | CM-Positions-ADL-Quantilschätzung (USER_DATA) | Keine | symbol, recvWindow | Ja |
/papi/v1/cm/conditional/allOpenOrders (DELETE) | Alle offenen CM-bedingten Orders stornieren (TRADE) | symbol | recvWindow | Ja |
/papi/v1/cm/allOpenOrders (DELETE) | Alle offenen CM-Orders stornieren (TRADE) | symbol | recvWindow | Ja |
/papi/v1/um/conditional/allOpenOrders (DELETE) | Alle offenen UM-bedingten Orders stornieren (TRADE) | symbol | recvWindow | Ja |
/papi/v1/um/allOpenOrders (DELETE) | Alle offenen UM-Orders stornieren (TRADE) | symbol | recvWindow | Ja |
/papi/v1/cm/conditional/order (DELETE) | CM-bedingte Order stornieren (TRADE) | symbol | strategyId, newClientStrategyId, recvWindow | Ja |
/papi/v1/cm/conditional/order (POST) | Neue CM-bedingte Order (TRADE) | symbol, side, strategyType | positionSide, timeInForce, quantity, reduceOnly, price, workingType, priceProtect, newClientStrategyId, stopPrice, activationPrice, callbackRate, recvWindow | Ja |
/papi/v1/cm/order (DELETE) | CM-Order stornieren (TRADE) | symbol | orderId, origClientOrderId, recvWindow | Ja |
/papi/v1/cm/order (PUT) | CM-Order ändern (TRADE) | symbol, side, quantity, price | orderId, origClientOrderId, priceMatch, recvWindow | Ja |
/papi/v1/cm/order (POST) | Neue CM-Order (TRADE) | symbol, side, type | positionSide, timeInForce, quantity, reduceOnly, price, priceMatch, newClientOrderId, newOrderRespType, recvWindow | Ja |
/papi/v1/cm/order (GET) | CM-Order abfragen (USER_DATA) | symbol | orderId, origClientOrderId, recvWindow | Ja |
/papi/v1/margin/allOpenOrders (DELETE) | Alle offenen Orders eines Margin-Kontos auf einem Symbol stornieren (TRADE) | symbol | recvWindow | Ja |
/papi/v1/margin/orderList (DELETE) | OCO-Orders des Margin-Kontos stornieren (TRADE) | symbol | orderListId, listClientOrderId, newClientOrderId, recvWindow | Ja |
/papi/v1/margin/orderList (GET) | OCO des Margin-Kontos abfragen (USER_DATA) | Keine | orderListId, origClientOrderId, recvWindow | Ja |
/papi/v1/margin/order (DELETE) | Order des Margin-Kontos stornieren (TRADE) | symbol | orderId, origClientOrderId, newClientOrderId, recvWindow | Ja |
/papi/v1/margin/order (POST) | Neue Margin-Order (TRADE) | symbol, side, type | quantity, quoteOrderQty, price, stopPrice, newClientOrderId, newOrderRespType, icebergQty, sideEffectType, timeInForce, selfTradePreventionMode, autoRepayAtCancel, recvWindow | Ja |
/papi/v1/margin/order (GET) | Order des Margin-Kontos abfragen (USER_DATA) | symbol | orderId, origClientOrderId, recvWindow | Ja |
/papi/v1/um/conditional/order (DELETE) | UM-bedingte Order stornieren (TRADE) | symbol | strategyId, newClientStrategyId, recvWindow | Ja |
/papi/v1/um/conditional/order (POST) | Neue UM-bedingte Order (TRADE) | symbol, side, strategyType | positionSide, timeInForce, quantity, reduceOnly, price, workingType, priceProtect, newClientStrategyId, stopPrice, activationPrice, callbackRate, priceMatch, selfTradePreventionMode, goodTillDate, recvWindow | Ja |
/papi/v1/um/order (DELETE) | UM-Order stornieren (TRADE) | symbol | orderId, origClientOrderId, recvWindow | Ja |
/papi/v1/um/order (PUT) | UM-Order ändern (TRADE) | symbol, side, quantity, price | orderId, origClientOrderId, priceMatch, recvWindow | Ja |
/papi/v1/um/order (POST) | Neue UM-Order (TRADE) | symbol, side, type | positionSide, timeInForce, quantity, reduceOnly, price, newClientOrderId, newOrderRespType, priceMatch, selfTradePreventionMode, goodTillDate, recvWindow | Ja |
/papi/v1/um/order (GET) | UM-Order abfragen (USER_DATA) | symbol | orderId, origClientOrderId, recvWindow | Ja |
/papi/v1/um/feeBurn (GET) | UM-Futures-BNB-Burn-Status abrufen (USER_DATA) | Keine | recvWindow | Ja |
/papi/v1/um/feeBurn (POST) | BNB-Burn bei UM-Futures-Trades umschalten (TRADE) | feeBurn | recvWindow | Ja |
/papi/v1/marginLoan (POST) | Margin-Konto-Kredit (Margin Account Borrow) (MARGIN) | asset, amount | recvWindow | Ja |
/papi/v1/margin/order/oco (POST) | Neue OCO-Order des Margin-Kontos (TRADE) | symbol, side, quantity, price, stopPrice | listClientOrderId, limitClientOrderId, limitIcebergQty, stopClientOrderId, stopLimitPrice, stopIcebergQty, stopLimitTimeInForce, newOrderRespType, sideEffectType, recvWindow | Ja |
/papi/v1/margin/repay-debt (POST) | Margin-Konto-Schuldenrückzahlung (TRADE) | asset | amount, specifyRepayAssets, recvWindow | Ja |
/papi/v1/repayLoan (POST) | Margin-Konto-Rückzahlung (MARGIN) | asset, amount | recvWindow | Ja |
/papi/v1/margin/myTrades (GET) | Margin-Konto-Tradeliste (USER_DATA) | symbol | orderId, startTime, endTime, fromId, limit, recvWindow | Ja |
/papi/v1/cm/conditional/allOrders (GET) | Alle CM-bedingten Orders abfragen (USER_DATA) | Keine | symbol, strategyId, startTime, endTime, limit, recvWindow | Ja |
/papi/v1/cm/allOrders (GET) | Alle CM-Orders abfragen (USER_DATA) | symbol | pair, orderId, startTime, endTime, limit, recvWindow | Ja |
/papi/v1/cm/conditional/openOrders (GET) | Alle aktuellen offenen CM-bedingten Orders abfragen (USER_DATA) | Keine | symbol, recvWindow | Ja |
/papi/v1/cm/openOrders (GET) | Alle aktuellen offenen CM-Orders abfragen (USER_DATA) | Keine | symbol, pair, recvWindow | Ja |
/papi/v1/um/conditional/openOrders (GET) | Alle aktuellen offenen UM-bedingten Orders abfragen (USER_DATA) | Keine | symbol, recvWindow | Ja |
/papi/v1/um/openOrders (GET) | Alle aktuellen offenen UM-Orders abfragen (USER_DATA) | Keine | symbol, recvWindow | Ja |
/papi/v1/margin/allOrders (GET) | Alle Margin-Konto-Orders abfragen (USER_DATA) | symbol | orderId, startTime, endTime, limit, recvWindow | Ja |
/papi/v1/um/conditional/allOrders (GET) | Alle UM-bedingten Orders abfragen (USER_DATA) | Keine | symbol, strategyId, startTime, endTime, limit, recvWindow | Ja |
/papi/v1/um/allOrders (GET) | Alle UM-Orders abfragen (USER_DATA) | symbol | orderId, startTime, endTime, limit, recvWindow | Ja |
/papi/v1/cm/conditional/orderHistory (GET) | CM-bedingte Orderhistorie abfragen (USER_DATA) | symbol | strategyId, newClientStrategyId, recvWindow | Ja |
/papi/v1/cm/orderAmendment (GET) | CM-Änderungshistorie abfragen (TRADE) | symbol | orderId, origClientOrderId, startTime, endTime, limit, recvWindow | Ja |
/papi/v1/cm/conditional/openOrder (GET) | Aktuelle offene CM-bedingte Order abfragen (USER_DATA) | symbol | strategyId, newClientStrategyId, recvWindow | Ja |
/papi/v1/cm/openOrder (GET) | Aktuelle offene CM-Order abfragen (USER_DATA) | symbol | orderId, origClientOrderId, recvWindow | Ja |
/papi/v1/margin/openOrders (GET) | Aktuelle offene Margin-Order abfragen (USER_DATA) | symbol | recvWindow | Ja |
/papi/v1/um/conditional/openOrder (GET) | Aktuelle offene UM-bedingte Order abfragen (USER_DATA) | symbol | strategyId, newClientStrategyId, recvWindow | Ja |
/papi/v1/um/openOrder (GET) | Aktuelle offene UM-Order abfragen (USER_DATA) | symbol | orderId, origClientOrderId, recvWindow | Ja |
/papi/v1/margin/openOrderList (GET) | Offene OCO des Margin-Kontos abfragen (USER_DATA) | Keine | recvWindow | Ja |
/papi/v1/margin/allOrderList (GET) | Alle OCO des Margin-Kontos abfragen (USER_DATA) | Keine | fromId, startTime, endTime, limit, recvWindow | Ja |
/papi/v1/um/conditional/orderHistory (GET) | UM-bedingte Orderhistorie abfragen (USER_DATA) | symbol | strategyId, newClientStrategyId, recvWindow | Ja |
/papi/v1/um/orderAmendment (GET) | UM-Änderungshistorie abfragen (TRADE) | symbol | orderId, origClientOrderId, startTime, endTime, limit, recvWindow | Ja |
/papi/v1/cm/forceOrders (GET) | Nutzer-CM-Zwangsorders abfragen (USER_DATA) | Keine | symbol, autoCloseType, startTime, endTime, limit, recvWindow | Ja |
/papi/v1/margin/forceOrders (GET) | Nutzer-Margin-Zwangsorders abfragen (USER_DATA) | Keine | startTime, endTime, current, size, recvWindow | Ja |
/papi/v1/um/forceOrders (GET) | Nutzer-UM-Zwangsorders abfragen (USER_DATA) | Keine | symbol, autoCloseType, startTime, endTime, limit, recvWindow | Ja |
/papi/v1/um/userTrades (GET) | UM-Konto-Tradeliste (USER_DATA) | symbol | startTime, endTime, fromId, limit, recvWindow | Ja |
/papi/v1/um/adlQuantile (GET) | UM-Positions-ADL-Quantilschätzung (USER_DATA) | Keine | symbol, recvWindow | Ja |
/papi/v1/listenKey (DELETE) | Benutzerdaten-Stream schließen (USER_STREAM) | Keine | Keine | Nein |
/papi/v1/listenKey (PUT) | Benutzerdaten-Stream verlängern (USER_STREAM) | Keine | Keine | Nein |
/papi/v1/listenKey (POST) | Benutzerdaten-Stream starten (USER_STREAM) | Keine | Keine | Nein |
Authentifizierung
Um geschützte Endpunkte zu nutzen, legen Sie die folgenden Umgebungsvariablen fest:
BINANCE_API_KEY– Ihr Binance-API-KeyBINANCE_SECRET_KEY– Ihr Binance-Secret-Key
Optional: Für die Nutzung des Testnetzwerks setzen Sie BINANCE_TESTNET=true.
Die API-Anfragen werden mit HMAC-SHA256 signiert. Der Secret-Key muss vor der Nutzung korrekt konfiguriert sein.
Nutzung
Rufen Sie den gewünschten Endpunkt mit den entsprechenden Parametern auf. Für die meisten Endpunkte ist ein recvWindow (in Millisekunden) erforderlich, um Zeitabweichungen zu tolerieren. Beispiel:
Anfrage: GET /papi/v1/balance?recvWindow=5000
Die Antwort erfolgt im JSON-Format mit den entsprechenden Kontodaten.
Fehlerbehandlung
Bei API-Fehlern gibt der Endpunkt einen entsprechenden HTTP-Statuscode und eine JSON-Fehlermeldung zurück. Häufige Fehler:
-1000ALLGEMEINER_FEHLER-1013FILTER_NICHT_EINGEHALTEN-2014UNGÜLTIGER_API_KEY_FORMAT-2015UNGÜLTIGE_API_SIGNATUR
Überprüfen Sie bei Authentifizierungsfehlern, dass Ihre API-Schlüssel korrekt gesetzt sind und die Systemzeit mit der Binance-Serverzeit synchronisiert ist.