Get Liquidation Price

Get the estimated liquidation price of an open position, optionally after a hypothetical margin change. The price is returned in USDT.

Request

# Current liquidation price (INR position)
curl -X GET "https://trade.mudrex.com/fapi/v1/futures/positions/{position_id}/liq-price?trade_currency=INR" \
  -H "X-Authentication: your-secret-key"

# Liquidation price after adding 50 INR of margin (INR position)
curl -X GET "https://trade.mudrex.com/fapi/v1/futures/positions/{position_id}/liq-price?trade_currency=INR&ext_margin=50" \
  -H "X-Authentication: your-secret-key"

Parameters

Parameter	Type	Required	Description
`position_id`	string	Yes	Position UUID (path parameter).
`ext_margin`	number	No	Hypothetical margin change in the position's currency: positive to add, negative to reduce. Omitted or `0` returns the current liquidation price.
`trade_currency`	string	Conditional	`USDT` or `INR`. Defaults to `USDT`. Required as `INR` when `ext_margin` is sent for an INR position.

Response

Status: 200 OK

Current liquidation price:

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

With ext_margin=50:

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

Response fields

Field	Description
`data`	Estimated liquidation price (string, USDT). Values computed with `ext_margin` are not rounded to the price step.

Errors

❕Common errors

HTTP	Error text	Meaning
400	`margin less than required margin`	Negative `ext_margin` takes the margin below the initial margin required at the position's leverage.
400	`margin cannot be greater than max margin`	`ext_margin` exceeds the margin that can be added.

{
    "success": false,
    "errors": [
        { "code": 400, "text": "margin less than required margin" }
    ]
}

Status: 400 Bad Request

Notes

For an INR position, send trade_currency=INR with ext_margin. Without it, any non-zero ext_margin returns 400. Requests without ext_margin return the same value with or without trade_currency.
Margin cannot be reduced below the initial margin required at the position's leverage. A position with no added margin rejects any negative ext_margin.
To apply a margin change, use Add/reduce margin.