Guides
Guides

Leverage by asset id/symbol

Check the leverage level and margin type set for a given asset, in a given currency. Leverage is stored per (asset, currency); the same symbol can carry different leverage in INR and USDT.

An asset for which leverage has never been set in that currency returns 404 leverage not found. Querying the same asset in the other currency is independent and may still succeed.

Request

# USDT (default)
curl -X GET "https://trade.mudrex.com/fapi/v1/futures/BTCUSDT/leverage?is_symbol" \
  -H "X-Authentication: your-secret-key"
# INR
curl -X GET "https://trade.mudrex.com/fapi/v1/futures/BTCUSDT/leverage?is_symbol&trade_currency=INR" \
  -H "X-Authentication: your-secret-key"

Parameters

ParameterTypeRequiredDescription
asset_idstringYesAsset UUID (path) or trading symbol if is_symbol is present.
is_symbolstringNoQuery parameter. If present, the asset_id path parameter is treated as a trading symbol instead of asset ID.
trade_currencystringNoUSDT or INR. Defaults to USDT when omitted.

Response

Status: 200 OK

{
    "success": true,
    "data": {
        "margin_type": "ISOLATED",
        "leverage": "2",
        "collateral_currency_id": 0
    }
}

Response fields

FieldDescription
margin_typeMargin type for the (asset, currency). Currently only ISOLATED.
leverageLeverage set for the asset in the requested currency.
collateral_currency_idInternal collateral currency identifier.

Errors

Common errors

Leverage not set in this currency

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

Status: 404 Not Found

Returned when leverage has never been set for this (asset, currency) pair — for example, querying ETHUSDT in INR before setting it.