Skip to main content
The quote endpoint enables you to request quotes for various operations including token swaps, cross-chain bridges, and complex multichain transactions. Below are practical examples for different scenarios.

​
Overview

Each example below shows both the JSON request body and the complete cURL command. You can copy the cURL commands directly to test the API, or use the JSON format with your preferred HTTP client.
For interactive testing, use the API Reference playground.
Account Types: Learn more about the differences between Basic, EIP-7702, and Role-Based accounts in our Account Models guide. Basic accounts provide simple setup, EIP-7702 preserves existing EOA addresses, and Role-Based accounts offer enhanced security features.

​
Aggregated Token to Aggregated Token Swap

Both source and destination chains are optimized by the Toolkit.
  • Basic Account
  • EIP-7702 Account
  • Role-Based Account
{
  "from": {
    "account": {
      "type": "kernel-v3.1-ecdsa",
      "signerAddress": "0x5d6fb4eb211a6a2e406a1111b54d26c534753c8e",
      "accountAddress": "0xE20295ec513DEf805D9c3083b0C8EaB64692D764"
    },
    "asset": {
      "assetId": "ob:eth"
    },
    "amount": "1000000000000000"
  },
  "to": {
    "asset": {
      "assetId": "ob:usdc"
    }
  }
}

​
Aggregated Token to Chain-Specific Token with Custom Recipient

The source chain (where to take the assets from) is optimized by the Toolkit, while the destination chain is explicitly specified. There is a different recipient on the destination chain.
  • Basic Account
  • EIP-7702 Account
  • Role-Based Account
{
  "from": {
    "account": {
      "type": "kernel-v3.1-ecdsa",
      "signerAddress": "0x5d6fb4eb211a6a2e406a1111b54d26c534753c8e",
      "accountAddress": "0xE20295ec513DEf805D9c3083b0C8EaB64692D764"
    },
    "asset": {
      "assetId": "ob:usdc"
    },
    "amount": "1000000"
  },
  "to": {
    "asset": {
      "assetId": "eip155:8453/erc20:0x532f27101965dd16442e59d40670faf5ebb142e4"
    },
    "account": "eip155:8453:0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
  }
}

​
Chain-Specific Token to Chain-Specific Token Swap

Direct swap between tokens on specific chains without aggregation.
  • Basic Account
  • EIP-7702 Account
  • Role-Based Account
{
  "from": {
    "account": {
      "type": "kernel-v3.1-ecdsa",
      "signerAddress": "0x5d6fb4eb211a6a2e406a1111b54d26c534753c8e",
      "accountAddress": "0xE20295ec513DEf805D9c3083b0C8EaB64692D764"
    },
    "asset": {
      "assetId": "eip155:8453/erc20:0x2da56acb9ea78330f947bd57c54119debda7af71" 
    },
    "amount": "1000000000000000000000000"
  },
  "to": {
    "asset": {
      "assetId": "eip155:8453/erc20:0x9a26f5433671751c3276a065f57e5a02d2817973" 
    }
  }
}

​
Chain-Specific Token to Aggregated Token

Convert a chain-specific token to an aggregated token for broader liquidity access.
  • Basic Account
  • EIP-7702 Account
  • Role-Based Account
{
  "from": {
    "account": {
      "type": "kernel-v3.1-ecdsa",
      "signerAddress": "0x5d6fb4eb211a6a2e406a1111b54d26c534753c8e",
      "accountAddress": "0xE20295ec513DEf805D9c3083b0C8EaB64692D764"
    },
    "asset": {
      "assetId": "eip155:8453/erc20:0x2da56acb9ea78330f947bd57c54119debda7af71"
    },
    "amount": "1000000000000000000000000"
  },
  "to": {
    "asset": {
      "assetId": "ob:usdc"
    }
  }
}

​
Cross-Chain Bridge Operation

Bridge the same token between different chains (e.g., USDC from Arbitrum to Optimism).
  • Basic Account
  • EIP-7702 Account
  • Role-Based Account
{
  "from": {
    "account": {
      "type": "kernel-v3.1-ecdsa",
      "signerAddress": "0x5d6fb4eb211a6a2e406a1111b54d26c534753c8e",
      "accountAddress": "0xE20295ec513DEf805D9c3083b0C8EaB64692D764"
    },
    "asset": {
      "assetId": "eip155:42161/erc20:0xaf88d065e77c8cc2239327c5edb3a432268e5831" 
    },
    "amount": "1000000"
  },
  "to": {
    "asset": {
      "assetId": "eip155:10/erc20:0x0b2c639c533813f4aa9d7837caf62653d097ff85"
    }
  }
}
⌘I