Skip to main content

​
Use Case

Enable users to onramp fiat into stablecoins on various chains. This works via spinning up virtual IBANs in the names of customers which are tied to automatic onramping rules. Examples:
  • Create a vIBAN 1 which turns EUR to USDC on Solana address 1
  • Create a vIBAN 2 which turns EUR to USDC on Arbitrum address 1
  • Create a vIBAN 3 which turns EUR to EURC on Arbitrum address 2

​
Example Flow

1
Max sets up a vIBAN 1 with an autoramp which turns EUR to USDC on Solana address 3DkN…BV4Lm
2
Max triggers a EUR 1000 transfer from their banking app
3
Iron will monitor the vIBAN 1; as soon as funds arrive 1100 USDC are delivered to 3DkN…BV4Lm
4
Max can at any time transfer more funds into this vIBAN 1 and they autoramp to USDC. It is persistent.

​
Implementation

Follow these example steps to integrate create an autoramp logic for EUR to USDC on Solana.

​
Request

curl -X POST "https://api.sandbox.iron.xyz/api/autoramps" \
  -H "Content-Type: application/json; charset=utf-8" \
  -H "IDEMPOTENCY-KEY: <your-idempotency-key>" \
  -H "X-API-Key: <your-api-key>" \
  -d '{
    "source_currencies": [{
      "type": "Fiat",
      "code": "EUR"
    }],
    "destination_currency": {
      "type": "Crypto",
      "token": "USDC",
      "blockchain": "Ethereum"
    },
    "recipient_account": {
      "type": "Crypto",
      "blockchain": "Ethereum",
      "address": "myholdings.eth"
    },
    "customer_id": "123e4567-e89b-12d3-a456-426614174000",
    "source_is_third_party": false
  }'

​
Response

{
  "id": "f8f9a8c7-d8b1-4f1a-8f15-7e6c8a1a8e50",
  "status": "Created",
  "deposit_account": {
    "type": "Iban",
    "id": "abc12345-defg-6789-hijk-9876543210",
    "iban": "DE89370400440532013000",
    "name": "Max Mustermann",
    "bic": "COBADEFFXXX",
    "bank_name": "Good Bank",
    "bank_country": "Germany",
    "currency": {
      "code": "EUR"
    }
  },
  "created_at": "2025-01-20T12:34:56Z"
}
Now you are ready to show the user their custom Iron IBAN which will be auto-connected to this onramp rule. Please note that vIBANs are named. No specific deposit instructions are required. Related Guide: For more details, refer to the API Reference Documentation.