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.

Authenticating creates an agent session and provisions agent wallets on all supported blockchains automatically. You only need to do this once per environment. Sessions last 7 days. This is a prerequisite for all other wallet operations, including Fund wallet, Transfer USDC, Bridge USDC, and Pay for service.
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

Choose the flow that matches your environment. Use Interactive when you can respond to prompts in a terminal. Use Non-interactive for scripts and AI agents that can’t respond to interactive prompts.
1

Run the login command

Run circle wallet login with your email address:
circle wallet login you@example.com
To authenticate for testnet instead, add --testnet to the command. Sessions are stored separately for mainnet and testnet.
On first run, Circle CLI prompts you to accept the Terms of Use and Privacy Policy.
2

Enter the one-time password

Check your email for the one-time password from Circle. Enter it in the terminal to verify your identity. You should see output similar to:
Logged in as you@example.com
Agent wallets are created automatically on all supported blockchains.
3

Get your wallet address

List your wallets to find the address for the blockchain you want to use:
circle wallet list --type agent --chain BASE
Copy the address returned. You’ll need it for funding your wallet, transferring USDC, depositing for nanopayments, and other operations.
See the CLI Command Reference for full syntax and options.