Get Position Summary

Description

Get position summary

HTTP Request

• GET /api/v3/copy/futures/position-summary
• Rate limit: 5/sec/UID
• Permission:
  • Unified Account — Futures Copy-Trading Positions — Read-only.

Request

curl "https://api.bitget.com/api/v3/copy/futures/position-summary" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*" \
   -H "ACCESS-PASSPHRASE:*" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json" 

Request Parameters

N/A

Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1774957537393,
  "data": [
    {
      "unrealizedPnl": "0.0095",
      "realizedPnl": "-0.0085658580000000",
      "holdSize": "0.01",
      "avgPrice": "2039.49",
      "symbol": "ETHUSDT",
      "leverage": "10",
      "marginMode": "crossed",
      "liqPrice": "0",
      "margin": "2.04900984",
      "holdSide": "long",
      "roi": "0.0046363857202896",
      "markPrice": "2040.44",
      "positionValue": "20.4044"
    }
  ]
}

Response Parameters

Parameter	Type	Comments
unrealizedPnl	String	Unrealized PnL unit：USDT
realizedPnl	String	Realized PnL unit：USDT
holdSize	String	Position size
avgPrice	String	Average entry price
symbol	String	Symbol name
leverage	String	Leverage multiplier positive integer
marginMode	String	Margin mode： isolated isolated， cross cross
liqPrice	String	Liquidation price
margin	String	Margin
holdSide	String	Position side： long long， short short
roi	String	Return on investment (ROI)
markPrice	String	Mark price
positionValue	String	Position value unit：USDT