Skip to main content
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 28 days. Session secrets are stored in your operating system’s secure keychain. Run circle wallet logout to clear the session. This is a prerequisite for all other wallet operations, including Fund wallet, Transfer USDC, Bridge USDC, and Pay for service.
Never give an AI agent unrestricted access to your email account. Circle sends a one-time password (OTP) to the email you log in with. Anyone who can read that inbox can use the OTP code to log in to your agent wallet. They can then perform any wallet operation, including changing your spending policies. Enter the OTP code yourself instead of giving your agent access to your email.

​
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:
To use testnet, add --testnet to the command. Sessions are stored separately for mainnet and testnet and expire after 28 days.
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:
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:
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.