Skip to main content
Circle CLI gives developers and AI agents a unified interface for onchain operations. Create and manage wallets, transfer, swap, and bridge USDC across blockchains, execute smart contracts, and discover or pay for services. All through a single command interface, without integrating multiple APIs and SDKs. Use Circle CLI to access:
  • Agent Wallets: Wallets with email OTP authentication, full onchain capabilities, and customizable policy enforcement.
  • Local wallets: Self-custodial wallets imported from a private key or mnemonic, stored using the Open Wallet Standard.
  • Agent Nanopayments: Gas-free, batched USDC payments for x402-compatible services.
  • Circle products: CCTP for USDC bridging, Gateway for unified USDC balances, Circle Contracts for smart contract queries, and Circle Skills for extending your agent with Circle-specific capabilities.

​
Installation

Install Circle CLI from npm (requires Node.js v20.18.2 or later):
Verify the installation:
Once installed, you can run any Circle CLI command. If your version is no longer supported, run circle update.

​
Get started

Create an Agent Wallet

Create an agent wallet and fund it with USDC.

Make a nanopayment

Send a gas-free USDC payment for an x402-protected resource.

CLI Command Reference

All Circle CLI commands, options, and examples.