Skip to main content
POST
/
virtual-wallets
/
bank-ramps
/
ramp-off
/
simulate
curl -X POST "https://api.cryptomate.me/virtual-wallets/bank-ramps/ramp-off/simulate" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "vw_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "bank_account_id": "ba_xyz789",
    "amount": 0.5
  }'
{
  "original_amount": 0.5,
  "original_currency": "USDC",
  "exchange_rate": 1.05,
  "converted_amount": 955.00,
  "service_fee": 5.00,
  "final_amount": 950.00,
  "final_currency": "USD"
}
Simulates a bank ramp-off (crypto to fiat) to preview conversion rates, fees, and final amounts before execution. Requires an API key with access level 2 or higher.

Body

wallet_id
string
required
Virtual wallet identifier.
bank_account_id
string
required
Bank account identifier for withdrawal.
amount
number
required
Amount in cryptocurrency to convert and withdraw.
reference
string
Bank statement reference (concept) for the transfer. Required when the destination bank account currency is COP; ignored otherwise. Maximum 18 characters.

Response

original_amount
number
Original crypto amount to convert.
original_currency
string
Original cryptocurrency token. One of USDC, USDT, DAI, ETH, BTC, MATIC, BNB, SOL.
exchange_rate
number
Exchange rate applied.
converted_amount
number
Amount after currency conversion.
service_fee
number
Service fee charged.
final_amount
number
Final fiat amount after fees.
final_currency
string
Final fiat currency. One of USD, EUR, MXN, BRL, GBP, COP.
curl -X POST "https://api.cryptomate.me/virtual-wallets/bank-ramps/ramp-off/simulate" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "vw_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "bank_account_id": "ba_xyz789",
    "amount": 0.5
  }'
{
  "original_amount": 0.5,
  "original_currency": "USDC",
  "exchange_rate": 1.05,
  "converted_amount": 955.00,
  "service_fee": 5.00,
  "final_amount": 950.00,
  "final_currency": "USD"
}