Get Liquidation Price

Calculate the estimated liquidation price for a proposed position based on position size, leverage, and market conditions.

HTTP Request

GET /api/v1/future/account/liq-price

Request Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Trading pair symbol (e.g., BTCUSDT)
posSide	string	Yes	Position side: "LONG" or "SHORT"
orderType	string	Yes	Order type: "LIMIT" or "MARKET"
openAmount	string	Yes	Position size to open
openPrice	string	No	Opening price (required when orderType is "LIMIT")

Request Example

Market Order Request

curl -X GET "https://open-api.bydoxe.com/api/v1/future/account/liq-price?symbol=BTCUSDT&posSide=LONG&orderType=MARKET&openAmount=0.5" \
  -H "ACCESS-KEY: your-api-key" \
  -H "ACCESS-SIGN: your-signature" \
  -H "ACCESS-PASSPHRASE: your-passphrase" \
  -H "ACCESS-TIMESTAMP: 1659076670000"

Limit Order Request

curl -X GET "https://open-api.bydoxe.com/api/v1/future/account/liq-price?symbol=BTCUSDT&posSide=LONG&orderType=LIMIT&openAmount=0.5&openPrice=90000.00" \
  -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	object	Liquidation price data
> liqPrice	string	Estimated liquidation price for the position

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1732000000000,
  "data": {
    "liqPrice": "81000.00"
  }
}

Error Codes

Code	Message
40034	symbol does not exist
40001	Order price is required
40001	Order amount is too large
40001	Insufficient balance
40002	Order price decimal precision is too high
40002	Order amount decimal precision is too high