Guides
Guides

Asset by id/symbol

Pull detailed metadata about a specific asset using its ID.

Unchanged by margin currency. This endpoint has no trade_currency parameter; the response is identical for USDT and INR traders. Prices and specs are USDT-denominated.

Request

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

Parameters

ParameterTypeRequiredDescription
asset_idstringYesThe unique identifier of the asset (path parameter) or trading symbol (e.g. "BTCUSDT") if is_symbol query parameter is present.
is_symbolstringNoQuery parameter. If present, the asset_id path parameter is treated as a trading symbol instead of asset ID.

Symbol-First Trading

You can use trading symbols (e.g. "BTCUSDT") instead of asset IDs by including the is_symbol query parameter:

curl -X GET "https://trade.mudrex.com/fapi/v1/futures/BTCUSDT?is_symbol" \
  -H "X-Authentication: your-secret-key"

The is_symbol query parameter need not have a value — its mere presence is enough. If it is not passed, the existing Asset ID support is used (backward compatible).

Response

Status: 200 OK

{
    "success": true,
    "data": {
        "id": "01903bc9-973a-7106-99e2-08287b632806",
        "name": "Ethereum",
        "symbol": "ETHUSDT",
        "min_contract": "0.01",
        "max_contract": "7240",
        "quantity_step": "0.01",
        "min_price": "0.01",
        "max_price": "199999.98",
        "price_step": "0.01",
        "max_market_contract": "724",
        "min_notional_value": "5",
        "funding_fee_perc": "0.0001",
        "max_funding_rate": null,
        "min_funding_rate": null,
        "trading_fee_perc": "0.1",
        "leverage_step": "0.01",
        "min_leverage": "1",
        "max_leverage": "100",
        "funding_interval": 1759305600,
        "price": "4147.18",
        "last_day_price": "4178.99",
        "change_perc": "-0.7611887082764",
        "volume": "1429617.28",
        "popularity": "2",
        "1d_high": 4205.82,
        "1d_low": 4089.48,
        "1d_volume": 1429617.2799999975
    }
}

Response fields

FieldDescription
idAsset ID used to create positions in a particular asset.
nameAsset name (e.g. "Ethereum").
symbolTrading symbol (e.g. "ETHUSDT").
min_contractMinimum quantity for which a position can be opened (base asset).
max_contractMaximum quantity for which a position can be opened (base asset).
quantity_stepMultiple of min contract value. Contracts must be in multiples of this value.
min_priceMinimum price for SL/TP or Limit orders (USDT).
max_priceMaximum price for SL/TP or Limit orders (USDT).
price_stepPrice increment step.
max_market_contractMaximum contract size for market orders.
min_notional_valueMinimum notional value for orders (USDT).
funding_fee_percFunding fee percentage.
max_funding_rateMaximum funding rate (can be null).
min_funding_rateMinimum funding rate (can be null).
trading_fee_percTrading fee percentage.
leverage_stepLeverage increment step. Valid leverage must be between min_leverage and max_leverage in multiples of this step.
min_leverageMinimum allowed leverage.
max_leverageMaximum allowed leverage.
funding_intervalFunding interval in EPOCH time. Regular period at which funding fees are exchanged.
priceCurrent market price (USDT).
last_day_pricePrice from the previous day.
change_percPercentage change in price.
volumeTrading volume.
popularityPopularity ranking of the asset.
1d_high24-hour high price.
1d_low24-hour low price.
1d_volume24-hour trading volume.

Errors

Common errors

Asset not found

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

Status: 404 Not Found