Get Position List

Description

Get the position details of a specified position.

Responses

🟢200OK

application/json

Body

code

string

required

data

array [object {44}]

required

string

required

Position ID

symbol

string

required

Symbol of the contract, Please refer to Get Symbol endpoint: symbol

Examples:

XBTUSDTMXBTUSDMETHUSDTM

marginMode

enum<string>

required

Margin Mode: CROSS，ISOLATED

Allowed values:

CROSSISOLATED

crossMode

boolean

required

Whether it is cross margin.

delevPercentage

number

required

ADL ranking percentile

openingTimestamp

integer <int64>

required

First opening time

currentTimestamp

integer <int64>

required

Current timestamp

currentQty

integer

required

Current postion quantity

currentCost

number

required

Current postion value

currentComm

number

required

Current commission

unrealisedCost

number

required

Unrealised value

realisedGrossCost

number

required

Accumulated realised gross profit value

realisedCost

number

required

Current realised position value

unrealisedPnl

number

required

Unrealised profit and loss

unrealisedPnlPcnt

number

required

Profit-loss ratio of the position

unrealisedRoePcnt

number

required

Rate of return on investment

realisedGrossPnl

number

required

Accumulated realised gross profit value

isOpen

boolean

required

Opened position or not

markPrice

number

required

Mark price

markValue

number

required

Mark Value

posCost

number

required

Position value

posInit

number

required

Inital margin Cross = opening value/cross leverage; isolated = accumulation of initial margin for each transaction

posMargin

number

required

Bankruptcy cost Cross = mark value * imr; Isolated = position margin (accumulation of initial margin, additional margin, generated funding fees, etc.)

realisedPnl

number

required

Realised profit and loss

avgEntryPrice

number

required

Average entry price

liquidationPrice

number

required

Liquidation price For Cross Margin, you can refer to the liquidationPrice, and the liquidation is based on the risk rate.

bankruptPrice

number

required

Bankruptcy price For Cross Margin, you can refer to the bankruptPrice, and the liquidation is based on the risk rate.

settleCurrency

string

required

Currency used to clear and settle the trades

isInverse

boolean

required

Reverse contract or not

positionSide

enum<string>

required

Position Side

Allowed value:

BOTH

leverage

number

required

Leverage

maintMarginReq

number

optional

Maintenance margin requirement

posMaint

number

optional

Maintenance margin

autoDeposit

boolean

optional

Auto deposit margin or not Only applicable to Isolated Margin

riskLimit

number

optional

Risk limit Only applicable to Isolated Margin

realLeverage

number

optional

Leverage of the order Only applicable to Isolated Margin

posCross

number

optional

added margin Only applicable to Isolated Margin

posCrossMargin

number

optional

Additional margin calls (automatic, manual, adjusted risk limits) Only applicable to Isolated Margin

posComm

number

optional

Bankruptcy cost Only applicable to Isolated Margin

posCommCommon

number

optional

Part of bankruptcy cost (positioning, add margin) Only applicable to Isolated Margin

posLoss

number

optional

Funding fees paid out Only applicable to Isolated Margin

posFunding

number

optional

The current remaining unsettled funding fee for the position Only applicable to Isolated Margin

maintMargin

number

optional

Position margin Only applicable to Isolated Margin

maintainMargin

number

optional

Maintenance margin rate Only applicable to Isolated Margin

Example

{
  "code": "200000",
  "data": [
    {
      "id": "500000000001046430",
      "symbol": "ETHUSDM",
      "crossMode": true,
      "delevPercentage": 0.71,
      "openingTimestamp": 1730635780702,
      "currentTimestamp": 1730636040926,
      "currentQty": 1,
      "currentCost": -0.0004069805,
      "currentComm": 2.441e-7,
      "unrealisedCost": -0.0004069805,
      "realisedGrossCost": 0,
      "realisedCost": 2.441e-7,
      "isOpen": true,
      "markPrice": 2454.12,
      "markValue": -0.000407478,
      "posCost": -0.0004069805,
      "posInit": 0.0000406981,
      "posMargin": 0.0000407478,
      "realisedGrossPnl": 0,
      "realisedPnl": -2.441e-7,
      "unrealisedPnl": -4.975e-7,
      "unrealisedPnlPcnt": -0.0012,
      "unrealisedRoePcnt": -0.0122,
      "avgEntryPrice": 2457.12,
      "liquidationPrice": 1429.96,
      "bankruptPrice": 1414.96,
      "settleCurrency": "ETH",
      "isInverse": true,
      "marginMode": "CROSS",
      "positionSide": "BOTH",
      "leverage": 10
    },
    {
      "id": "500000000000988255",
      "symbol": "XBTUSDTM",
      "autoDeposit": true,
      "crossMode": false,
      "maintMarginReq": 0.005,
      "riskLimit": 500000,
      "realLeverage": 2.97,
      "delevPercentage": 0.5,
      "openingTimestamp": 1729155616322,
      "currentTimestamp": 1730636040926,
      "currentQty": 1,
      "currentCost": 67.4309,
      "currentComm": -0.15936162,
      "unrealisedCost": 67.4309,
      "realisedGrossCost": 0,
      "realisedCost": -0.15936162,
      "isOpen": true,
      "markPrice": 68323.06,
      "markValue": 68.32306,
      "posCost": 67.4309,
      "posCross": 0.06225152,
      "posCrossMargin": 0,
      "posInit": 22.2769666644,
      "posComm": 0.0539821899,
      "posCommCommon": 0.0539447199,
      "posLoss": 0.26210915,
      "posMargin": 22.1310912243,
      "posFunding": -0.19982016,
      "posMaint": 0.4046228699,
      "maintMargin": 23.0232512243,
      "realisedGrossPnl": 0,
      "realisedPnl": -0.2402787,
      "unrealisedPnl": 0.89216,
      "unrealisedPnlPcnt": 0.0132,
      "unrealisedRoePcnt": 0.04,
      "avgEntryPrice": 67430.9,
      "liquidationPrice": 45704.44,
      "bankruptPrice": 45353.8,
      "settleCurrency": "USDT",
      "isInverse": false,
      "maintainMargin": 0.005,
      "marginMode": "ISOLATED",
      "positionSide": "BOTH",
      "leverage": 2.97
    }
  ]
}

Request

Request samples

Responses