Skip to main content
Version: Next

Current Position

Query current open futures positions and asset statistics.

API Information

  • Method: POST
  • Path: /api/v1/futures/open-api/position/current

Request Parameters

ParameterTypeRequiredDescription
symbolstringNoFilter by futures trading pair
coTypeintNoFilter by contract type: 1=US stocks, 2=Hong Kong stocks, 3=Cryptocurrency

Response Structure (data object):

FieldTypeDescription
balancestringWallet balance
AcctBalancestringAccount balance
assetValuationstringAsset valuation
pnlTotalstringTotal floating P&L
posListarrayPosition list

Request Example

{
"symbol": "BTCUSDT",
"coType": 3
}

Position Object Fields (posList array)

FieldTypeDescription
idint64Position ID
symbolstringFutures trading pair
posNostringPosition number
longFlagintDirection: 1=Long (Buy), 2=Short (Sell)
marginModeintMargin mode: 1=Cross, 2=Isolated
leveragestringCurrent leverage
posMarginstringPosition margin
useMarginstringAvailable margin (Isolated only)
feeCoststringDeducted fees
nowAmtTotalstringCurrent position total value (USD)
nowVolTotalstringCurrent position total quantity
sellVolTotalstringTotal sell volume
sellAmtTotalstringTotal sell amount (USD)
buyVolTotalstringTotal buy volume
freezeVolstringFrozen quantity from orders
pnlstringFloating P&L
realPnlstringRealized P&L
liqPricestringEstimated liquidation price
avgPricestringAverage open price
markPricestringMark price
maintMarginstringMaintenance margin amount
closePricestringActual close/liquidation price (when position is 0)
closeTimeint64Full close time (when position is 0)
ctimeint64Creation time (milliseconds)
rateReturnstringReturn rate (%)
marginRatestringMargin rate (%) = Maintenance margin / Account equity × 100
holdMarginRatiostringMaintenance margin ratio
initMarginstringInitial margin ratio
posStatusintPosition status: 1=Not triggered (active)
pricePrecisionintPrice precision
coTypeintContract type: 1=US stocks, 2=Hong Kong stocks, 3=Cryptocurrency
profitPricestringTake profit price
lossPricestringStop loss price

Response Example

{
"code": 200,
"data": {
"balance": "5000.00"
}
}