Guides
Guides

Get Liquidation Price

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

Request

curl -X GET "https://trade.mudrex.com/fapi/v1/futures/positions/{position_id}/liq-price?ext_margin=2.1" \
  -H "X-Authentication: your-secret-key"

Parameters

ParameterTypeRequiredDescription
position_idstringYesThe unique identifier of the position (path parameter)
ext_marginfloatNoAdditional margin amount (positive for adding margin, negative for reducing margin). If not passed or zero, returns current liquidation price

Response

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

Parameters

ParameterDescription
dataEstimated liquidation price (string)

Examples

Get current liquidation price (no query parameter)

curl -X GET "https://trade.mudrex.com/fapi/v1/futures/positions/{position_id}/liq-price" \
  -H "X-Authentication: your-secret-key"

Get estimated liquidation price after adding margin

curl -X GET "https://trade.mudrex.com/fapi/v1/futures/positions/{position_id}/liq-price?ext_margin=10.5" \
  -H "X-Authentication: your-secret-key"

Get estimated liquidation price after reducing margin

curl -X GET "https://trade.mudrex.com/fapi/v1/futures/positions/{position_id}/liq-price?ext_margin=-5.2" \
  -H "X-Authentication: your-secret-key"

Common errors

Position not found

{
    "success": false,
    "errors": [
        {
            "code": 404,
            "text": "Position not found"
        }
    ]
}

Status: 404 Not Found

This error occurs when the position ID is incorrect or the position does not exist.