Get Current Position

Description

Get information about your current position.

HTTP Request

GET /v3/trade/position/opens

Request Parameters

Parameter	Required	Type	Description
symbol	No	String	Trading pair; if the field is empty, you will get the information about all of your current positions.

Response Parameters

Parameter	Type	Description
symbol	String	A trading pair
side	String	Enumerate: BUY, SELL
mgnMode	String	Margin Mode, Enumerate: ISOLATED, CROSS
posSide	String	Position side LONG SHORT BOTH
openAvgPx	String	Average entry price
qty	String	Conts of positions (Position size after execution)
availQty	String	Conts available to close
lever	String	Leverage, from 1 to 75.
adl	String	ADL (Auto-Deleveraging)
liqPx	String	Est. liquidation price
im	String	Initial margin
mm	String	Maintenance margin
mgn	String	Isolated position margin
maxWAmt	String	ISOLATED maximum amount that can be withdrawn
upl	String	Unrealized PnL (calculated based on mark price)
uplRatio	String	Unrealized PnL% (calculated based on mark price)
pnl	String	Realized PnL
markPx	String	Mark price
lastPx	String	Last price
indexPx	String	Index price
mgnRatio	String	Margin rate
state	String	Position Status: NORMAL, LIQ, and ADL
actType	String	Account type
tpTrgPx	String	Take profit trigger price
slTrgPx	String	Stop loss trigger price
cTime	String	Creation time
uTime	String	Update time

Request Example

{
    "symbol":"BTC_USDT_PERP"
}

Response Example

{
  "code": 200,
  "data": [
    {
      "adl": "0.1666",
      "availQty": "1",
      "cTime": "1719894977164",
      "im": "1.955006333333333333",
      "lever": "30",
      "liqPx": "0",
      "markPx": "58650.19",
      "lastPx": "58650.19",
      "indexPx": "58650.19",
      "mgn": "1.955006333333333333",
      "maxWAmt": "100000",  
      "mgnMode": "CROSS",
      "posSide": "BOTH",
      "mgnRatio": "0",
      "mm": "0.322576045",
      "openAvgPx": "58651",
      "pnl": "0",
      "qty": "1",
      "side": "BUY",
      "state": "NORMAL",
      "actType": "TRADING", 
      "tpTrgPx": "58670",
      "slTrgPx": "61003",  
      "symbol": "BTC_USDT_PERP",
      "uTime": "1719974554434",
      "upl": "-0.00081",
      "uplRatio": "-0.0004"
    }
  ],
  "msg": "Success"
}