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": "10000",
        "quantity_step": "0.01",
        "min_price": "0.01",
        "max_price": "199999.98",
        "price_step": "0.01",
        "max_market_contract": "2000",
        "min_notional_value": "5",
        "funding_fee_perc": "0.0001",
        "max_funding_rate": "0.00333",
        "min_funding_rate": "-0.00333",
        "leverage_step": "0.01",
        "min_leverage": "1",
        "max_leverage": "150",
        "funding_interval": 1790697600,
        "previous_funding_interval": 1790668800,
        "price": "2686.83",
        "last_day_price": "2655.79",
        "change_perc": "1.1687671088452",
        "volume": "1171094.42",
        "popularity": "2",
        "1d_high": 2749.76,
        "1d_low": 2650.05,
        "1d_volume": 1171094.4200000009
    }
}

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).
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_intervalNext funding time, Unix epoch seconds (integer). See Funding interval.
previous_funding_intervalPrevious funding time, Unix epoch seconds (integer). See Funding interval.
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.

Funding interval

funding_interval and previous_funding_interval are timestamps in Unix epoch seconds (integers), not durations.

FieldMeaning
funding_intervalNext funding time.
previous_funding_intervalPrevious funding time.

Funding interval (seconds) = funding_interval - previous_funding_interval. Listed assets fund every 8 hours (28800) or every 4 hours (14400).

Example (ETHUSDT):

FieldEpoch secondsUTCIST (UTC+05:30)
funding_interval17906976002026-09-29 16:00:002026-09-29 21:30:00
previous_funding_interval17906688002026-09-29 08:00:002026-09-29 13:30:00
Interval288008 hours8 hours
from datetime import datetime, timezone, timedelta

next_ts, prev_ts = 1790697600, 1790668800
interval = next_ts - prev_ts                                   # 28800 (8 hours)
datetime.fromtimestamp(next_ts, timezone.utc)                  # 2026-09-29 16:00:00+00:00
datetime.fromtimestamp(next_ts, timezone(timedelta(hours=5, minutes=30)))  # 2026-09-29 21:30:00+05:30

Values are the same for USDT and INR, and on Asset listing and Asset by id/symbol.

Both fields can remain unchanged for 20 minutes or more after a funding event, so funding_interval can be earlier than the current time. The interval stays correct. In that case:

next_funding_time = funding_interval + (funding_interval - previous_funding_interval)

Errors

❕Common errors

Asset not found

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

Status: 404 Not Found


Did this page help you?