Guides
Guides

Get Liquidation Price

Get estimated liquidation price for a position, optionally with additional margin adjustment.

Get the estimated liquidation price for a position, optionally with an additional margin adjustment. The liquidation price is returned in USDT. The position's currency is inherited from its UUID.

Request

# INR position, current liquidation price
curl -X GET "https://trade.mudrex.com/fapi/v1/futures/positions/{position_id}/liq-price?trade_currency=INR" \
  -H "X-Authentication: your-secret-key"
# With a hypothetical margin change (ext_margin)
curl -X GET "https://trade.mudrex.com/fapi/v1/futures/positions/{position_id}/liq-price?ext_margin=1" \
  -H "X-Authentication: your-secret-key"

Parameters

ParameterTypeRequiredDescription
position_idstringYesThe unique identifier of the position (path parameter).
ext_marginfloatNoHypothetical margin change (positive to add, negative to reduce), in the position's currency. If omitted or 0, returns the current liquidation price.
trade_currencystringNoUSDT or INR. Defaults to USDT when omitted.

Response

Status: 200 OK

{
    "success": true,
    "data": "0.09293"
}

With ext_margin=1:

{
    "success": true,
    "data": "0.0926883614301247"
}

Response fields

FieldDescription
dataEstimated liquidation price (string, in USDT).