Asset by id/symbol
Pull detailed metadata about a specific asset using its ID.
Unchanged by margin currency. This endpoint has no
trade_currencyparameter; 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
| Parameter | Type | Required | Description |
|---|---|---|---|
asset_id | string | Yes | The unique identifier of the asset (path parameter) or trading symbol (e.g. "BTCUSDT") if is_symbol query parameter is present. |
is_symbol | string | No | Query 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
| Field | Description |
|---|---|
id | Asset ID used to create positions in a particular asset. |
name | Asset name (e.g. "Ethereum"). |
symbol | Trading symbol (e.g. "ETHUSDT"). |
min_contract | Minimum quantity for which a position can be opened (base asset). |
max_contract | Maximum quantity for which a position can be opened (base asset). |
quantity_step | Multiple of min contract value. Contracts must be in multiples of this value. |
min_price | Minimum price for SL/TP or Limit orders (USDT). |
max_price | Maximum price for SL/TP or Limit orders (USDT). |
price_step | Price increment step. |
max_market_contract | Maximum contract size for market orders. |
min_notional_value | Minimum notional value for orders (USDT). |
funding_fee_perc | Funding fee percentage. |
max_funding_rate | Maximum funding rate (can be null). |
min_funding_rate | Minimum funding rate (can be null). |
leverage_step | Leverage increment step. Valid leverage must be between min_leverage and max_leverage in multiples of this step. |
min_leverage | Minimum allowed leverage. |
max_leverage | Maximum allowed leverage. |
funding_interval | Next funding time, Unix epoch seconds (integer). See Funding interval. |
previous_funding_interval | Previous funding time, Unix epoch seconds (integer). See Funding interval. |
price | Current market price (USDT). |
last_day_price | Price from the previous day. |
change_perc | Percentage change in price. |
volume | Trading volume. |
popularity | Popularity ranking of the asset. |
1d_high | 24-hour high price. |
1d_low | 24-hour low price. |
1d_volume | 24-hour trading volume. |
Funding interval
funding_interval and previous_funding_interval are timestamps in Unix epoch seconds (integers), not durations.
| Field | Meaning |
|---|---|
funding_interval | Next funding time. |
previous_funding_interval | Previous funding time. |
Funding interval (seconds) = funding_interval - previous_funding_interval. Listed assets fund every 8 hours (28800) or every 4 hours (14400).
Example (ETHUSDT):
| Field | Epoch seconds | UTC | IST (UTC+05:30) |
|---|---|---|---|
funding_interval | 1790697600 | 2026-09-29 16:00:00 | 2026-09-29 21:30:00 |
previous_funding_interval | 1790668800 | 2026-09-29 08:00:00 | 2026-09-29 13:30:00 |
| Interval | 28800 | 8 hours | 8 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:30Values 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
Updated about 1 month ago
