Get Single Position

Returns position information of a single symbol, response including estimated liquidation price.

HTTP Request

GET /api/v1/future/position/single-position

Request Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Trading pair symbol (e.g., BTCUSDT)

Request Example

curl -X GET "https://open-api.bydoxe.com/api/v1/future/position/single-position?symbol=BTCUSDT" \
  -H "ACCESS-KEY: your-api-key" \
  -H "ACCESS-SIGN: your-signature" \
  -H "ACCESS-PASSPHRASE: your-passphrase" \
  -H "ACCESS-TIMESTAMP: 1659076670000"

Response Parameters

Parameter	Type	Description
code	string	Response code
msg	string	Response message
requestTime	number	Request timestamp in milliseconds
data	array	Single position data
> marginCoin	string	Margin coin (e.g., USDT)
> symbol	string	Trading pair symbol
> holdSide	string	Position direction: "long" or "short"
> openDelegateSize	string	Amount to be filled of the current order (base coin)
> marginSize	string	Margin amount (margin coin)
> available	string	Available amount for positions (base currency)
> locked	string	Frozen amount in the position (base currency)
> total	string	Total amount of all positions (available + locked)
> leverage	string	Leverage multiplier
> achievedProfits	string	Realized PnL (excluding funding fee and transaction fee)
> openPriceAvg	string	Average entry price
> marginMode	string	Margin mode: "isolated" or "cross"
> unrealizedPL	string	Unrealized profit and loss
> liquidationPrice	string	Estimated liquidation price (≤0 means low risk, no liquidation price)
> marginRate	string	Margin rate
> keepMarginRate	string	Tiered maintenance margin rate
> markPrice	string	Current mark price
> breakEvenPrice	string	Position breakeven price
> totalFee	string	Accumulated funding fee during the position
> cTime	number	Creation time in milliseconds (Unix timestamp)
> uTime	number	Last updated time in milliseconds (Unix timestamp)

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1732000000000,
  "data": [
    {
      "marginCoin": "USDT",
      "symbol": "BTCUSDT",
      "holdSide": "long",
      "openDelegateSize": "0.05",
      "marginSize": "4500.00",
      "available": "0.45",
      "locked": "0.05",
      "total": "0.50",
      "leverage": "10",
      "achievedProfits": "25.50",
      "openPriceAvg": "90000.00",
      "marginMode": "isolated",
      "unrealizedPL": "500.00",
      "liquidationPrice": "81000.00",
      "marginRate": "0.1082",
      "keepMarginRate": "0.005",
      "markPrice": "91000.00",
      "breakEvenPrice": "90150.00",
      "totalFee": "12.50",
      "cTime": 1731900000000,
      "uTime": 1732000000000
    }
  ]
}

Error Codes

Code	Message
40034	symbol does not exist
50010	Upstream response invalid