circle <resource> <verb> [options] pattern. All commands
support --help for inline documentation.
Global options
Wallet commands
Manage your agent wallet.circle wallet login
Authenticate using email OTP to create or access an agent wallet session.
Syntax
Examples
Request IDs from
--init expire after 10 minutes and are deleted after a
successful --request.circle wallet logout
Clear stored credentials for the current session.
Syntax
Example
circle wallet status
Show the current authentication status and session details.
Syntax
Example
circle wallet create
Create an additional wallet, separate from the wallets provisioned during login.
Each user can have at most 5 agent wallets.
Syntax
Example
circle wallet list
List wallets associated with your account.
Syntax
Example
circle wallet limit
Show spending policy limits for an agent wallet. Mainnet only.
Syntax
Examples
circle wallet limit set
Set a custom spending policy for an agent wallet. Requires a second email OTP to
confirm the change. Mainnet only.
Use --rule-type to choose the kind of policy:
transfer-limit(default): cap how much USDC the wallet can transfer per transaction or over a rolling time window. Set with--per-tx,--daily,--weekly,--monthly.recipient-allowlist/recipient-blocklist: allow or block transfers to specific recipient addresses. Set with--targets.contract-allowlist/contract-blocklist: allow or block contract interactions with specific addresses. Set with--targets.
Transfer limits must satisfy: per-transaction ≤ daily ≤ weekly ≤ monthly.
circle wallet limit reset
Reset all custom spending policies for an agent wallet back to defaults.
Requires a second email OTP to confirm. Mainnet only.
Syntax
Example
circle wallet limit budget
Show remaining spending budgets for an agent wallet. Displays per-transaction
limits and rolling-window remaining amounts (daily, weekly, monthly). Budgets
are EVM-wide and not blockchain-specific. Mainnet only.
Syntax
Example
circle wallet balance
Show the token balance for a wallet address on a given blockchain.
Syntax
Example
circle wallet fund
Add funds to a wallet by transfer from another wallet (crypto), through a fiat
onramp, or from the testnet faucet.
Syntax
Examples
circle wallet transfer
Transfer tokens from a wallet to another address.
Syntax
Options
Example
circle wallet swap
Swap one token for another. Requires an agent wallet. Arc Testnet is the only
testnet supported.
Syntax
Options
Examples
circle wallet sign message
Sign a plain text or hex-encoded message with your wallet.
Syntax
Options
Example
circle wallet sign typed-data
Sign EIP-712 typed data with your wallet.
Syntax
Options
Example
circle wallet execute
Execute a smart contract write function from a wallet.
Syntax
Options
Example
circle wallet import
Import a local wallet from a private key or mnemonic phrase. Stored using the
Open Wallet Standard at ~/.ows/wallets/<name>.
Syntax
Example
Services commands
Discover and pay for x402-compatible API services.circle services search
Search for available services by keyword. Omit the query to list all services.
Syntax
Options
Example
circle services inspect
Inspect the payment requirements for a service URL. The CLI auto-detects the
HTTP method from the service’s discovery metadata and auto-generates a minimal
request body from its input schema. Override either with the flags below.
Syntax
Options
Example
circle services pay
Pay for a service using your agent wallet.
Syntax
Options
Example
Bridge commands
Bridge USDC across blockchains using CCTP.circle bridge transfer
Bridge USDC from one blockchain to another.
Syntax
Options
Example
circle bridge status
Check the status of a bridge transfer by transaction hash.
Syntax
Options
Example
circle bridge get-fee
Get the estimated fee for bridging from a given blockchain.
Syntax
Options
Example
Gateway commands
Interact with Circle Gateway.circle gateway balance
Show your Gateway balance for nanopayments.
Syntax
Examples
circle gateway deposit
Deposit USDC into Circle Gateway for nanopayments. Minimum deposit is 0.5
USDC.
Syntax
Eco is a third-party fast-deposit service that Circle does not operate or
audit. Review Eco’s
docs
and test the flow before using it in production.
circle gateway withdraw
Withdraw USDC from Circle Gateway back to a wallet on the same blockchain.
Syntax
Withdrawals are same-chain only. The withdrawn USDC is minted on
--chain.
Agent wallets must be Smart Contract Accounts (SCAs). Pass the SCA address as
--address. JSON output includes transferId, estimatedFee, and
chargedFee.Blockchain commands
Query supported blockchain information.circle blockchain list
List all blockchains supported by Circle CLI.
Syntax
circle blockchain config
Show or update the RPC URL for a blockchain.
Syntax
Examples
Transaction commands
Manage pending and submitted transactions.circle transaction list
List transaction history for a wallet.
Syntax
Examples
circle transaction cancel
Cancel a pending transaction.
Syntax
Options
Example
circle transaction accelerate
Accelerate a pending transaction by increasing the gas fee.
Syntax
Options
Example
Contract commands
Interact with onchain contracts.circle contract address
Show Circle contract addresses, optionally filtered by category and blockchain.
Syntax
Options
Examples
circle contract query
Execute a read-only contract call.
Syntax
Options
Examples
Skill commands
Discover and install skills from thecirclefin/skills catalog.
The
--tool option specifies your agent framework. Common values:
claude-code, cursor, codex.circle skill list
List all available skills from the catalog.
Syntax
circle skill info
Show details and full content for a specific skill.
Syntax
Example
circle skill install
Install a skill into your agent framework.
Syntax
Examples
circle skill update
Update installed skills for an agent framework.
Syntax
Terms commands
Inspect, accept, or reset your local Circle CLI Terms of Use acceptance record. The first time you run any command, Circle CLI prompts you to accept the Terms of Use and Privacy Policy. Acceptance is stored locally and reused on subsequent runs. To handle Terms acceptance non-interactively in scripts and AI agents, usecircle terms accept or set CIRCLE_ACCEPT_TERMS=1 in the environment.
circle terms
Show the current acceptance status and the canonical Terms of Use and Privacy
Policy URLs. Default verb is show.
Syntax
Examples