Position Information V2

Type: USER-DATA

Weight: 5

GET /fapi/v2/positionRisk (alias GET /fapi/v1/positionRisk)

Current open positions with risk metrics. v1 and v2 are served by the same handler and return the same shape.

Request

GET /fapi/v2/positionRisk?symbol=BTCUSDT&timestamp=<ms>&signature=<hex>

Query params

Name	Type	Required	Notes
symbol	string	no	Omit for all open positions.

Response — 200

[
  {
    "symbol": "BTCUSDT",
    "positionAmt": "0.5",
    "entryPrice": "59800.00",
    "breakEvenPrice": "59800.00",
    "markPrice": "60050.50",
    "unRealizedProfit": "125.2500",
    "leverage": "10",
    "marginType": "cross",
    "isolatedMargin": "2990.00",
    "positionSide": "LONG",
    "notional": "30025.25",
    "isolatedWallet": "2990.00",
    "updateTime": 1714261234567
  }
]

Field	Notes
positionAmt	Signed: positive long, negative short.
breakEvenPrice	Currently equals entryPrice (fees / funding not amortised).
marginType	Always "cross".
isolatedMargin / isolatedWallet	Both carry the position's locked collateral; in cross mode this is an accounting snapshot only.
positionSide	Direction of the open position (LONG / SHORT), not the hedge-mode side.

Only open positions are returned; there is no zero-amount row per symbol.

Authentication failures (INVALID_API_KEY, API_KEY_DISABLED, IP_NOT_ALLOWED, SIGNATURE_INVALID) apply to every signed endpoint and use Sparky's {"success":false,"error":{...}} envelope; see Error Codes.