Guides
v1.0.8
Guides

Transfer funds

Move funds instantly between your spot wallet and futures wallet to manage trading positions and margin requirements. Transfers move funds within a single currency.


USDT and INR use different endpoints. USDT transfers go through POST /wallet/futures/transfer. INR transfers go through POST /futures/transfers/inr. The two paths differ in their response shapes. The USDT path does not accept INR, and cross-currency transfers (INR ↔ USDT) are not supported via API.

USDT transfer — POST /wallet/futures/transfer

Request

curl -X POST "https://trade.mudrex.com/fapi/v1/wallet/futures/transfer" \
  -H "Content-Type: application/json" \
  -H "X-Authentication: your-secret-key" \
  -d '{
    "from_wallet_type": "SPOT",
    "to_wallet_type": "FUTURES",
    "amount": "10.5"
  }'

Parameters

ParameterTypeRequiredDescription
from_wallet_typestringYesSource wallet: "SPOT" or "FUTURES"
to_wallet_typestringYesDestination wallet: must be opposite of source
amountstringYesDecimal amount to transfer (must be positive)

Response

Status: 202 Accepted

{
    "success": true,
    "data": {
        "msg": "internal_wallet_fund_transfer_request accepted"
    }
}

Response fields

FieldDescription
msgConfirmation that the transfer request was accepted.

INR transfer — POST /futures/transfers/inr

The currency is implied by the path; do not send trade_currency in the body. A SPOT → FUTURES move appears as a DEPOSIT, and FUTURES → SPOT as a WITHDRAW, in Transactions.

Request

# INR: SPOT → FUTURES
curl -X POST "https://trade.mudrex.com/fapi/v1/futures/transfers/inr" \
  -H "Content-Type: application/json" \
  -H "X-Authentication: your-secret-key" \
  -d '{
    "amount": "89.12",
    "from_wallet_type": "SPOT",
    "to_wallet_type": "FUTURES"
  }'
# INR: FUTURES → SPOT
curl -X POST "https://trade.mudrex.com/fapi/v1/futures/transfers/inr" \
  -H "Content-Type: application/json" \
  -H "X-Authentication: your-secret-key" \
  -d '{
    "amount": "14.6719",
    "from_wallet_type": "FUTURES",
    "to_wallet_type": "SPOT"
  }'

Parameters

ParameterTypeRequiredDescription
from_wallet_typestringYesSource wallet: "SPOT" or "FUTURES"
to_wallet_typestringYesDestination wallet: must be opposite of source
amountstringYesDecimal INR amount to transfer (must be positive)

Response

Status: 202 Accepted

{
    "success": true,
    "data": {
        "id": "019ecc51-9004-7dd1-8654-64420289af4e"
    }
}

Response fields

FieldDescription
idTransfer transaction ID, queryable via the Transactions endpoint.

Errors

Common errors

Insufficient balance — source wallet empty or amount too high.

{
    "success": false,
    "errors": [
        {
            "code": null,
            "text": "insufficient balance"
        }
    ]
}

Status: 400 Bad Request

INR sent to the USDT transfer path — POST /wallet/futures/transfer with "trade_currency": "INR" is rejected. Use /futures/transfers/inr for INR.

{
    "success": false,
    "errors": [
        {
            "code": null,
            "text": "insufficient balance"
        }
    ]
}

Status: 400 Bad Request

Same wallet type selected

{
    "success": false,
    "errors": [
        {
            "code": null,
            "text": "From and To wallet types must be different"
        }
    ]
}

Status: 400 Bad Request

Notes

  • Transfers are instant and free of fees.
  • The wallets must be different (SPOT ↔ FUTURES), within the same currency.
  • You must have sufficient balance in the source wallet.