Guides
Guides

Assets

Get a paginated list of all tradable futures asset.

Request

curl -X GET "https://trade.mudrex.com/fapi/v1/futures?sort=price&order=desc&offset=0&limit=3" \
  -H "X-Authentication: your-secret-key"

Parameters

ParameterTypeRequiredDescription
sortstringNoSort by: price, volume, change_perc, or popularity (default)
orderstringNoSort order: asc or desc
offsetnumberNoNumber of records to skip (default: 0)
limitnumberNoMaximum number of records to return (default: 20)

Response

{
    "success": true,
    "data": [
        {
            "id": "01903a7b-bf65-707d-a7dc-d7b84c3c756c",
            "name": "Bitcoin",
            "symbol": "BTCUSDT",
            "min_contract": "0.001",
            "max_contract": "1190",
            "quantity_step": "0.001",
            "min_price": "0.1",
            "max_price": "1999999.8",
            "price_step": "0.1",
            "max_market_contract": "119",
            "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": "114550",
            "last_day_price": "114060.7",
            "change_perc": "0.42898211215607",
            "volume": "66940.704",
            "popularity": "1"
        }
    ]
}

Parameters

ParameterDescription
idAsset ID used to create positions in a particular asset. Example: "01903a7b-bf65-707d-a7dc-d7b84c3c756c" is for BTC
nameAsset name (e.g., "Bitcoin")
symbolTrading symbol (e.g., "BTCUSDT")
min_contractMinimum quantity for which a position can be opened in an asset
max_contractMaximum quantity for which a position can be opened in an asset
quantity_stepMultiple of min contract value. Contracts must be in multiples of this value (e.g., 0.001, 0.002, 0.003)
min_priceMinimum price for SL/TP or Limit orders
max_priceMaximum price for SL/TP or Limit orders
price_stepPrice increment step
max_market_contractMaximum contract size for market orders
min_notional_valueMinimum notional value for orders
funding_fee_percFunding fee percentage
max_funding_rateMaximum funding rate (correct values, can be null)
min_funding_rateMinimum funding rate (correct values, 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
last_day_pricePrice from the previous day
change_percPercentage change in price
volumeTrading volume
popularityPopularity ranking of the asset

Pagination

Pagination is controlled by the limit and offset query parameters. Use limit to specify how many assets to return (default 10) and offset to skip a number of assets (default 0). When combined, these allow you to paginate through the full list of futures assets.

The response returns an array of asset objects. Each object contains fields like id (asset identifier), symbol (trading pair), price (current price), volume24h (24-hour trading volume), and changePerc (24-hour price change percentage). Use these fields to display basic market information about each asset.