Same-chain swaps (Alpha)
Swaps let you convert any token to any other token onchain. They’re built natively into Smart Wallets and you can integrate in minutes.
Smart Wallets also allow you to add actions after the swap completes. For example, you can deposit your newly swapped tokens into a DeFi protocol.
Swaps work just like any other Smart Wallet transaction, so you can sponsor gas to do gasless swaps, or pay for gas in an ERC-20 token.
Cross-chain swaps are live! Send your first cross-chain swap now!
Swaps are in alpha. Note that there may be changes in the future to simplify the endpoint/sdk. We will let you know if/when that happens.
The Swap flow
Flow
- Request a swap quote
- Sign the prepared swap calls (including any post swap action)
- Send prepared calls
- Wait for onchain confirmation
Swap options
When requesting a swap quote, you can specify either an amount in, or a minimum amount out.
Prerequisites
Before you begin, ensure you have:
- An Alchemy API Key
- If you’re sponsoring gas, then a Gas Manager policy
- A small amount of USDC for testing (~$1 worth is enough!)
- Important: You’ll need to send these tokens to your smart wallet address to be able to swap!
 
- A signer to own the account and sign messages
React
JavaScript
APIs
Use the usePrepareSwap hook to request swap quotes and the useSignAndSendPreparedCalls hook to execute token swaps on the same chain.
Prerequisites
- Smart Wallets installed and configured in your project
- An authenticated user
- Tokens in your smart account to swap
How it works
- Request quote: usePrepareSwaprequests a swap quote and prepares the transaction calls
- Destructure result: Extract quotefor display andcallsfor signing
- Sign and send: useSignAndSendPreparedCallssigns and submits the transaction
- Track status: useWaitForCallsStatusmonitors the transaction until confirmation
The quote includes the minimum amount you’ll receive and the expiry time for the quote.
Swap options
You can specify either an exact input amount or a minimum output amount:
FAQs
What chains are supported?
Chains supported (for now) are: Ethereum, Arbitrum, Base, Berachain, BSC/BNB, Ink, Monad, Optimism, Polygon, Unichain and World Chain mainnets.
Does the Swap API support cross-chain swaps?
Currently, the Swap API supports only single-chain swaps. Cross-chain swaps are coming soon!
How do you encode values?
Values are simply passed as hexadecimal strings. The Swap API doesn’t add complexity to consider decimals, so 0x01 is always the smallest amount of a given asset.
1 ETH, or DAI (18 decimals) is 0xDE0B6B3A7640000
1 USDC (6 decimals) is 0xF4240
This removes any ambiguity— if it’s numerical, it’s a hex.
What is the expiry?
The expiry is an informational indicator of when you can expect to be able to process the swap request. If you’re at/near the expiry, it might be a good time to request a new quote.
What if I’m using React?
Use the @account-kit/react package to access a smartWalletClient. This package automatically uses the Signer for user authentication & signing. Check out the docs for getting started with React to learn more.