Get Available Withdrawal Currencies

Get a list of currencies that are available for withdrawal based on your current balance.

Endpoint

GET /withdrawal/available-currencies/

Description

This endpoint returns only the currencies that:

1. Are enabled for withdrawals
2. Have a positive balance in your account
3. Are configured for your tenant

This helps users see which currencies they can actually withdraw.

Authentication

Requires Bearer token with read scope.

Response

Success Response

Code: 200 OK

Content:

{
  "currencies": [
    {
      "currency": "USDTTRC20",
      "name": "Tether USD",
      "blockchain": "TRX",
      "token": "USDT",
      "balance": "1500.00000000",
      "min_withdrawal": "10.00000000",
      "max_withdrawal": "1500.00000000"
    },
    {
      "currency": "USDTARB",
      "name": "Tether USD",
      "blockchain": "ARB",
      "token": "USDT",
      "balance": "750.50000000",
      "min_withdrawal": "5.00000000",
      "max_withdrawal": "750.50000000"
    },
    {
      "currency": "BTC",
      "name": "Bitcoin",
      "blockchain": "BTC",
      "token": "BTC",
      "balance": "0.05432100",
      "min_withdrawal": "0.00010000",
      "max_withdrawal": "0.05432100"
    }
  ],
  "total": 3
}

Response Fields

Field	Type	Description
currencies	array	List of available currencies
currency	string	Currency code
name	string	Currency full name
blockchain	string	Blockchain network
token	string	Token symbol
balance	string	Current available balance
min_withdrawal	string	Minimum withdrawal amount
max_withdrawal	string	Maximum withdrawal amount (limited by balance)
total	number	Total number of available currencies

Example

Request

curl -X GET https://api.cryptofuse.com/withdrawal/available-currencies/ \
  -H "Authorization: Bearer your_token"

Response

{
  "currencies": [
    {
      "currency": "USDTTRC20",
      "name": "Tether USD",
      "blockchain": "TRX",
      "token": "USDT",
      "balance": "5000.00000000",
      "min_withdrawal": "10.00000000",
      "max_withdrawal": "5000.00000000"
    },
    {
      "currency": "ETH",
      "name": "Ethereum",
      "blockchain": "ETH",
      "token": "ETH",
      "balance": "2.50000000",
      "min_withdrawal": "0.01000000",
      "max_withdrawal": "2.50000000"
    }
  ],
  "total": 2
}

Use Cases

1. Withdrawal Form - Populate currency dropdown with only withdrawable options
2. Balance Check - Quick view of which currencies have funds
3. Withdrawal Planning - See limits for each currency

Notes

• Only shows currencies with positive balance
• max_withdrawal is the lesser of configured limit or available balance
• Currencies must be enabled for withdrawals in tenant configuration
• Does not include pending withdrawals in balance calculation
• Network fees are not deducted from shown balances

Error Responses

No Configuration

Code: 400 Bad Request

{
  "error": {
    "code": "invalid_request",
    "message": "Withdrawal currencies not configured",
    "details": {
      "error": "Configuration error"
    }
  }
}

Authentication Failed

Code: 401 Unauthorized

{
  "error": {
    "code": "authentication_failed",
    "message": "Invalid or missing authentication token"
  }
}

Related Endpoints

• Create Withdrawal - Create a withdrawal request
• Get Currencies - Get all available currencies
• Get Balance - Get detailed balance information