Guides
Guides

Funds (spot)

Retrieve your current Spot wallet balances. Pass currency to choose the wallet currency; omitted defaults to USDT.


Use currency, not trade_currency. The spot wallet is the only endpoint that takes currency (e.g. ?currency=INR). Passing trade_currency=INR here returns 200 OK with all-zero balances — a misleading empty wallet rather than your INR balance. Always read the INR spot wallet with ?currency=INR.

Request

# USDT (default)
curl -X GET "https://trade.mudrex.com/fapi/v1/wallet/funds" \
  -H "X-Authentication: your-secret-key"
# INR
curl -X GET "https://trade.mudrex.com/fapi/v1/wallet/funds?currency=INR" \
  -H "X-Authentication: your-secret-key"

Parameters

ParameterTypeRequiredDescription
currencystringNoWallet currency: USDT or INR. Defaults to USDT when omitted.

Response

Status: 200 OK

USDT:

{
    "success": true,
    "data": {
        "total": 4.13,
        "rewards": 0,
        "invested": 3.5,
        "withdrawable": 0.63,
        "coin_investable": 0.63,
        "coinset_investable": 0.63,
        "vault_investable": 0.63
    }
}

INR (?currency=INR):

{
    "success": true,
    "data": {
        "total": 15.67,
        "rewards": 0,
        "invested": 0,
        "withdrawable": 15.67,
        "coin_investable": 15.67,
        "coinset_investable": 15.67,
        "vault_investable": 15.67
    }
}

Response fields

FieldDescription
totalTotal value in the spot wallet, in the requested currency.
rewardsBonus funds earned from promotions, not withdrawable.
investedFunds currently locked in other Mudrex products.
withdrawableAmount available to withdraw or transfer to futures.
coin_investableAmount available for investment in individual coins.
coinset_investableAmount available for investment in coin sets.
vault_investableAmount available for investment in vaults.

Notes

  • All fields are denominated in the requested currency. The field shape is identical for USDT and INR.
  • Related: Transfer funds to move funds into the futures wallet.