Swap

Use Case

Enable users to swap token 1 into token 2 across various chains.

Examples:

• Setup wallet address 1 which turns incoming USDC on Solana into EURC on Arbitrum
• Setup wallet address 2 which turns incoming SOL on Solana into USDC on Arbitrum

Example Flow

1. User sets up a wallet address 1 on Solana owned by Iron

2. Now an autoramp is activated

   i. which turns all incoming USDC on wallet address 1 into EURC on Arbitrum

   ii. and delivers those into his connected wallet in wallet address 2

3. Now user sends 1000 USDC to wallet address 1

4. As soon as funds hit this address, Iron turns them into EURC on Arbitrum and delivers them to wallet address 2

This flow is a very easy way for applications to integrate bridging and automatic swaps without users having to interact with complex multi-step UIs. Send is the simplest API every wallet and frontend can integrate.

Implementation

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

Request

Shell

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_currency": {
      "type": "Crypto",
      "token": "USDC",
      "blockchain": "Solana"
    },
    "destination_currency": {
      "type": "Crypto",
      "token": "USDC",
      "blockchain": "Arbitrum"
    },
    "recipient_account": {
      "type": "Wallet",
      "blockchain": "Arbitrum",
      "address": "0xaf77d065e77c8cC2239327C5EDb3A432268e5831"
    },
    "customer_id": "123e4567-e89b-12d3-a456-426614174000",
    "source_is_third_party": false
  }'

Response

Shell

{
  "id": "d4e3c2b1-a9f8-7654-3210-fedcba987654",
  "status": "Created",
  "deposit_account": {
    "type": "Wallet",
    "id": "abc12345-defg-6789-hijk-9876543210",
    "blockchain": "Solana",
    "address": "savings.sol",
    "currency": {
      "code": "USDC"
    }
  },
  "created_at": "2025-01-20T14:23:45Z"
}

Now you are ready to show the user their custom wallet address which will be auto-connected to this offramp rule. Please also show supported assets for this wallet address (e.g. EURC, USDC). Non-supported assets will be returned to sender.

Related Guide: For more details, refer to the API Reference Documentation.