Position Information V3 (USER_DATA)

API Description

Get current position information(only symbol that has position or open orders will be returned).

HTTP Request

GET /fapi/v3/positionRisk

Request Weight

5

Request Parameters

Name	Type	Mandatory	Description
symbol	STRING	NO
recvWindow	LONG	NO
timestamp	LONG	YES

Note

Please use with user data stream ACCOUNT_UPDATE to meet your timeliness and accuracy needs.

Response Example

For One-way position mode:

[
  {
        "symbol": "ADAUSDT",                  // symbol
        "positionSide": "BOTH",               // position side
        "positionAmt": "30",                  // position amount, positive for long, negative for short
        "entryPrice": "0.385",                // entry price
        "breakEvenPrice": "0.385077",         // break-even price
        "markPrice": "0.41047590",            // current mark price
        "unRealizedProfit": "0.76427700",     // unrealized profit
        "liquidationPrice": "0",              // liquidation price
        "isolatedMargin": "0",                // isolated margin
        "notional": "12.31427700",            // notional value of position
        "marginAsset": "USDT",                // margin asset
        "isolatedWallet": "0",                // isolated wallet (if isolated position)
        "initialMargin": "0.61571385",        // initial margin required with current mark price
        "maintMargin": "0.08004280",          // maintenance margin required
        "positionInitialMargin": "0.61571385",// initial margin required for positions with current mark price
        "openOrderInitialMargin": "0",        // initial margin required for open orders with current mark price
        "adl": 2,                             // auto-deleverage ranking
        "bidNotional": "0",                   // ignore
        "askNotional": "0",                   // ignore
        "updateTime": 1720736417660           // update time
  }
]

For Hedge position mode:

[
  {
        "symbol": "ADAUSDT",                  // symbol
        "positionSide": "LONG",               // position side
        "positionAmt": "30",                  // position amount, positive for long, negative for short
        "entryPrice": "0.385",                // entry price
        "breakEvenPrice": "0.385077",         // break-even price
        "markPrice": "0.41047590",            // current mark price
        "unRealizedProfit": "0.76427700",     // unrealized profit
        "liquidationPrice": "0",              // liquidation price
        "isolatedMargin": "0",                // isolated margin
        "notional": "12.31427700",            // notional value of position
        "marginAsset": "USDT",                // margin asset
        "isolatedWallet": "0",                // isolated wallet (if isolated position)
        "initialMargin": "0.61571385",        // initial margin required with current mark price
        "maintMargin": "0.08004280",          // maintenance margin required
        "positionInitialMargin": "0.61571385",// initial margin required for positions with current mark price
        "openOrderInitialMargin": "0",        // initial margin required for open orders with current mark price
        "adl": 2,                             // auto-deleverage ranking
        "bidNotional": "0",                   // ignore
        "askNotional": "0",                   // ignore
        "updateTime": 1720736417660           // update time
  },
  {
        "symbol": "COMPUSDT",                 // symbol
        "positionSide": "SHORT",              // position side
        "positionAmt": "-1.000",              // position amount, positive for long, negative for short
        "entryPrice": "70.92841",             // entry price
        "breakEvenPrice": "70.900038636",     // break-even price
        "markPrice": "49.72023376",           // current mark price
        "unRealizedProfit": "21.20817624",    // unrealized profit
        "liquidationPrice": "2260.56757210",  // liquidation price
        "isolatedMargin": "0",                // isolated margin
        "notional": "-49.72023376",           // notional value of position
        "marginAsset": "USDT",                // margin asset
        "isolatedWallet": "0",                // isolated wallet (if isolated position)
        "initialMargin": "2.48601168",        // initial margin required with current mark price
        "maintMargin": "0.49720233",          // maintenance margin required
        "positionInitialMargin": "2.48601168",// initial margin required for positions with current mark price
        "openOrderInitialMargin": "0",        // initial margin required for open orders with current mark price
        "adl": 2,                             // auto-deleverage ranking
        "bidNotional": "0",                   // ignore
        "askNotional": "0",                   // ignore
        "updateTime": 1708943511656           // update time
  }
]