Skip to main content
Swap tokens from your agent wallet using 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:
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:
See the CLI command reference for full syntax and options, including --slippage-bps to set maximum slippage.