Guides
Guides

Transfer funds

Move funds instantly between your spot wallet (USDT Wallet) and futures wallet to manage trading positions and margin requirements.

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

FieldTypeRequiredDescription
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"
    }
}   d 

Examples

Request

{
    "from_wallet_type": "SPOT",
    "to_wallet_type": "FUTURES",
    "amount": "1"
}

Response

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

Common errors

Same wallet type selected

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

Status: 400 Bad Request

Insufficient funds

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

Status: 400 Bad Request


Notes

  • Transfers are instant and free of fees
  • You must have sufficient balance in the source wallet
  • The wallets must be different (SPOTFUTURES only)
  • Authentication is required for all transfer requests