> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cryptomate.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Simulate bank ramp-on

> Preview conversion rates and fees for a bank ramp-on.

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

<ParamField body="wallet_id" type="string" required>
  Virtual wallet identifier.
</ParamField>

<ParamField body="origin_currency" type="string" required>
  Source fiat currency. One of `USD`, `EUR`, `MXN`, `BRL`, `GBP`, `COP`.
</ParamField>

<ParamField body="amount" type="number" required>
  Amount in fiat currency to convert.
</ParamField>

## Response

<ResponseField name="original_amount" type="number">
  Original fiat amount.
</ResponseField>

<ResponseField name="original_currency" type="string">
  Original fiat currency.
</ResponseField>

<ResponseField name="final_amount" type="number">
  Final crypto amount after conversion and fees.
</ResponseField>

<ResponseField name="final_currency" type="string">
  Final cryptocurrency token. One of `USDC`, `USDT`.
</ResponseField>

<ResponseField name="exchange_rate" type="number">
  Exchange rate applied.
</ResponseField>

<ResponseField name="service_fee" type="number">
  Platform fee amount.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  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
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "original_amount": 1000.00,
    "original_currency": "USD",
    "final_amount": 995.00,
    "final_currency": "USDC",
    "exchange_rate": 1.00,
    "service_fee": 5.00
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "code": "NOT_FOUND",
    "message": "Wallet not found"
  }
  ```
</ResponseExample>