circle wallet swap. Optionally get a
price quote first to verify the expected output before committing funds.
Prerequisites
Before you begin, ensure that you’ve:- Installed Node.js v20.18.2 or later.
-
Installed Circle CLI:
- Completed the Agent Wallets quickstart (authenticates and funds your wallet).
If you use a contract allowlist on mainnet, include the ERC-20 token you sell
and Circle’s Swap Kit adapter contract at
0x7FB8c7260b63934d8da38aF902f87ae6e284a845 on that blockchain. Look up EURC on
Arc for the example in this guide:circle contract address doesn’t list Swap Kit contracts. If you sell a token
outside Circle’s catalog, confirm its contract address on that blockchain.
Review the
contract allowlist setup
before allowing these contracts.Steps
1
Get a quote (optional)
Run
circle wallet swap with --quote to see the estimated output without
executing the swap:2
Swap tokens
Run
circle wallet swap with your wallet address and a <buyAmount>
stop-limit. If the estimated output is less than this value onchain, the swap
fails instead of settling at an unfavorable rate:--slippage-bps to set maximum slippage.