Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.circle.com/llms.txt

Use this file to discover all available pages before exploring further.

Create an agent wallet and fund it with USDC on Base. Prefer a guided setup? Prompt your AI agent to set it up.
Your agent can only operate the wallet if it has access to the email address used during authentication. By default, only you receive the OTP. If you grant your agent access to your inbox, it can authenticate on your behalf and perform all wallet operations.

​
Prerequisites

Before you begin, ensure you have:

​
Steps

Follow these steps to create an agent wallet and fund it with USDC.
1

Authenticate

circle wallet login you@example.com
To use testnet instead, add --testnet to the command. Sessions are stored separately for mainnet and testnet and expire after 7 days.
On first run, Circle CLI prompts you to accept the Terms of Use and Privacy Policy. Then Circle sends a one-time password to verify your identity. After authentication, agent wallets are created automatically on all supported blockchains.
2

Get your wallet address

circle wallet list --type agent --chain BASE
Copy the wallet address returned. You will use it in the steps below.
3

Fund your wallet

Run circle wallet fund to add USDC to your wallet from another wallet you own. Replace 0xYourWalletAddress with the address from the previous step:
circle wallet fund --address 0xYourWalletAddress --chain BASE --amount 10 --method crypto
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 --method fiat to open the onramp provider in your browser. See Fund wallet for all funding options.
On Arc Testnet, omit --method and --amount to receive 2 USDC from the Circle faucet into your first agent wallet.
4

Check your balance

Confirm the funds arrived. Replace 0xYourWalletAddress with your wallet address:
circle wallet balance --address 0xYourWalletAddress --chain BASE

​
Next steps

Now that you have a funded wallet, you can: