Prerequisites
Before you begin, ensure you have:- Installed Node.js v20.18.2 or later.
-
Installed Circle CLI:
Steps
Follow these steps to create an agent wallet and fund it with USDC.1
Authenticate
To use testnet, add
--testnet to the command. Sessions are stored separately
for mainnet and testnet and expire after 28 days.2
Get your wallet address
3
Fund your wallet
Run The CLI prints a terminal QR code and an
EIP-681 deposit URI. Scan the QR
code with your mobile wallet to send the funds.To buy USDC with a card instead, pass
circle wallet fund to add USDC to your wallet from another wallet you
own. Replace 0xYourWalletAddress with the address from the previous step:--method fiat to open the onramp
provider in your browser. See
Fund wallet for all
funding options.To use testnet, replace
BASE with a testnet blockchain (for example,
ARC-TESTNET) and omit --method and --amount. On testnet, circle wallet fund draws 20 USDC from the Circle faucet. See supported
blockchains for the full
list.4
Check your balance
Confirm the funds arrived. Replace
0xYourWalletAddress with your wallet
address:Next steps
Now that you have a funded wallet, you can:- Deposit for nanopayments and pay for a service.
- Transfer USDC to another address.
- Bridge USDC to another blockchain.
- Swap tokens using your agent wallet.
- Explore wallet operations for more tasks.