Skip to main content
POST
/
virtual-wallets
/
bank-ramps
/
ramp-on
/
simulate
curl -X POST "https://api.cryptomate.me/virtual-wallets/bank-ramps/ramp-on/simulate" \
  -H "X-API-KEY: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "vw_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "origin_currency": "USD",
    "amount": 1000.00
  }'

{
  "original_amount": 1000.00,
  "original_currency": "USD",
  "final_amount": 995.00,
  "final_currency": "USDC",
  "exchange_rate": 1.00,
  "service_fee": 5.00
}
Simulates a bank ramp-on (fiat to crypto) 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.
​
origin_currency
string
required
Source fiat currency. One of BRL, USD, EUR, MXN.
​
amount
number
required
Amount in fiat currency to convert.

​
Response

​
original_amount
number
Original fiat amount.
​
original_currency
string
Original fiat currency.
​
final_amount
number
Final crypto amount after conversion and fees.
​
final_currency
string
Final cryptocurrency token. One of USDC, USDT.
​
exchange_rate
number
Exchange rate applied.
​
service_fee
number
Platform fee amount.
curl -X POST "https://api.cryptomate.me/virtual-wallets/bank-ramps/ramp-on/simulate" \
  -H "X-API-KEY: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "vw_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "origin_currency": "USD",
    "amount": 1000.00
  }'

{
  "original_amount": 1000.00,
  "original_currency": "USD",
  "final_amount": 995.00,
  "final_currency": "USDC",
  "exchange_rate": 1.00,
  "service_fee": 5.00
}