Quickstart: Create an agent wallet

Get your first agent wallet set up in minutes.

Create an agent wallet and fund it with USDC on Base using Circle CLI.

Prefer a guided setup? Paste this prompt into your AI agent instead:

Run curl -sL https://agents.circle.com/skills/setup.md, and use the returned setup instructions to set up my agent wallet.

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:

• Installed Node.js v20.18.2 or later.

• Installed Circle CLI:

  npm install -g @circle-fin/cli
  

Steps

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

1. Authenticate

   circle wallet login [e-mail]
   

   To use testnet, 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.

   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:

   circle wallet balance --address 0xYourWalletAddress --chain BASE
   

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.