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 Role-Based and Basic accounts in our Account Models guide. Role-Based accounts offer enhanced security features but consume slightly more gas, while Basic accounts provide simpler setup and integration.

​
Aggregated Token to Aggregated Token Swap

Both source and destination chains are optimized by the Toolkit.

{
  "from": {
    "account": {
      "sessionAddress": "0x1cBFbFd62a276BF6D79d504eA4CA75a7baDcf5b1",
      "adminAddress": "0xc162a3cE45ad151eeCd0a5532D6E489D034aB3B8",
      "accountAddress": "0xE20295ec513DEf805D9c3083b0C8EaB64692D764"
    },
    "asset": {
      "assetId": "ds:eth"
    },
    "amount": "1000000000000000"
  },
  "to": {
    "asset": {
      "assetId": "ds: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.

{
  "from": {
    "account": {
      "sessionAddress": "0x1cBFbFd62a276BF6D79d504eA4CA75a7baDcf5b1",
      "adminAddress": "0xc162a3cE45ad151eeCd0a5532D6E489D034aB3B8",
      "accountAddress": "0xE20295ec513DEf805D9c3083b0C8EaB64692D764"
    },
    "asset": {
      "assetId": "ds: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.

{
  "from": {
    "account": {
      "sessionAddress": "0x1cBFbFd62a276BF6D79d504eA4CA75a7baDcf5b1",
      "adminAddress": "0xc162a3cE45ad151eeCd0a5532D6E489D034aB3B8",
      "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.

{
  "from": {
    "account": {
      "sessionAddress": "0x1cBFbFd62a276BF6D79d504eA4CA75a7baDcf5b1",
      "adminAddress": "0xc162a3cE45ad151eeCd0a5532D6E489D034aB3B8",
      "accountAddress": "0xE20295ec513DEf805D9c3083b0C8EaB64692D764"
    },
    "asset": {
      "assetId": "eip155:8453/erc20:0x2da56acb9ea78330f947bd57c54119debda7af71"
    },
    "amount": "1000000000000000000000000"
  },
  "to": {
    "asset": {
      "assetId": "ds:usdc"
    }
  }
}

​
Cross-Chain Bridge Operation

Bridge the same token between different chains (e.g., USDC from Arbitrum to Optimism).

{
  "from": {
    "account": {
      "sessionAddress": "0x1cBFbFd62a276BF6D79d504eA4CA75a7baDcf5b1",
      "adminAddress": "0xc162a3cE45ad151eeCd0a5532D6E489D034aB3B8",
      "accountAddress": "0xE20295ec513DEf805D9c3083b0C8EaB64692D764"
    },
    "asset": {
      "assetId": "eip155:42161/erc20:0xaf88d065e77c8cc2239327c5edb3a432268e5831" 
    },
    "amount": "1000000"
  },
  "to": {
    "asset": {
      "assetId": "eip155:10/erc20:0x0b2c639c533813f4aa9d7837caf62653d097ff85"
    }
  }
}