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
posSide	String	Both sides
side	String	Enumerate: BUY, SELL
mgnMode	String	Margin Mode, Enumerate: ISOLATED, CROSS
ctType	String	Futures Type: Linear and inverse
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.
fee	String	Position closing fee
adl	String	ADL (Auto-Deleveraging)
liqPx	String	Est. liquidation price
im	String	Initial margin
mm	String	Maintenance margin
mgn	String	Isolated position margin
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
mgnRatio	String	Margin rate
state	String	Position Status: NORMAL, LIQ, and ADL
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",
      "mgn": "1.955006333333333333",
      "mgnMode": "CROSS",
      "mgnRatio": "0",
      "mm": "0.322576045",
      "openAvgPx": "58651",
      "pnl": "0",
      "posSide": "BOTH",
      "qty": "1",
      "side": "BUY",
      "state": "NORMAL",
      "symbol": "BTC_USDT_PERP",
      "uTime": "1719974554434",
      "upl": "-0.00081",
      "uplRatio": "-0.0004"
    }
  ],
  "msg": "Success"
}