Skip to main content
POST
/
cards
/
account
/
fees-wallet
/
withdraw
curl -X POST "https://api.cryptomate.me/cards/account/fees-wallet/withdraw" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "token_symbol": "USDC",
    "amount": 100.50,
    "destination_address": "0x1234567890abcdef1234567890abcdef12345678"
  }'

{
  "transaction_hash": "0xabc123def456abc123def456abc123def456abc123def456abc123def456abcd",
  "status": "PENDING",
  "simple_error_message": null,
  "detailed_error_message": null
}
Withdraws accumulated fees from your cards fees wallet to a destination address. Only the real on-chain balance of the selected token can be withdrawn — pending (uncredited) fees are not withdrawable. The destination must belong to your cards whitelist and have been enabled for at least 24 hours, counted from the moment it was added to the whitelist. Otherwise the request is rejected. Requires an API key with access level 3 or higher.

​
Body

​
token_symbol
string
required
Symbol of the token to withdraw (e.g. USDC). It must have an available on-chain balance in the fees wallet.
​
amount
number
required
Amount to withdraw. Must be greater than 0 and cannot exceed the available on-chain balance of the token. Up to 6 decimal places.
​
destination_address
string
required
Destination wallet address. Must be in the cards whitelist and enabled (added at least 24 hours ago).

​
Response

​
transaction_hash
string
On-chain transaction hash.
​
status
string
Transaction status. Possible values: PENDING, SUCCESS, FAILED, MANUAL_CHECK.
​
simple_error_message
string
Simple error message if the transaction failed.
​
detailed_error_message
string
Detailed error message with additional context.

​
Errors

CodeDescription
VALIDATION_ERRORThe destination address is not in the cards whitelist, has not been enabled for 24 hours yet, or a field is missing/invalid.
curl -X POST "https://api.cryptomate.me/cards/account/fees-wallet/withdraw" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "token_symbol": "USDC",
    "amount": 100.50,
    "destination_address": "0x1234567890abcdef1234567890abcdef12345678"
  }'

{
  "transaction_hash": "0xabc123def456abc123def456abc123def456abc123def456abc123def456abcd",
  "status": "PENDING",
  "simple_error_message": null,
  "detailed_error_message": null
}