Skip to main content
Circle CLI follows a 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
Options 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
Options Example

circle wallet status

Show the current authentication status and session details. Syntax
Options 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
Options Example

circle wallet list

List wallets associated with your account. Syntax
Options Example

circle wallet limit

Show spending policy limits for an agent wallet. Mainnet only. Syntax
Options 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.
Syntax
Options
Transfer limits must satisfy: per-transaction ≤ daily ≤ weekly ≤ monthly.
Examples

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
Options 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
Options Example

circle wallet balance

Show the token balance for a wallet address on a given blockchain. Syntax
Options 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
Options Examples

circle wallet transfer

Transfer tokens from a wallet to another address. Syntax
Arguments Options Example

circle wallet swap

Swap one token for another. Requires an agent wallet. Arc Testnet is the only testnet supported. Syntax
Arguments Options Examples

circle wallet sign message

Sign a plain text or hex-encoded message with your wallet. Syntax
Arguments Options Example

circle wallet sign typed-data

Sign EIP-712 typed data with your wallet. Syntax
Arguments Options Example

circle wallet execute

Execute a smart contract write function from a wallet. Syntax
Arguments 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>.
Local wallets bypass Circle’s compliance and safety controls. Spending policies, OFAC screening, and audit logging only apply to agent wallets.
Syntax
Options
Do not pass your private key or mnemonic as a command-line argument or environment variable in plain text. Enter it at the prompt or use a secrets manager.
Example

Services commands

Discover and pay for x402-compatible API services. Search for available services by keyword. Omit the query to list all services. Syntax
Arguments 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
Arguments Options Example

circle services pay

Pay for a service using your agent wallet. Syntax
Arguments Options Example
Failed payments write debug logs to ~/.circle-cli/payments/. Check the most recent file for the request, response, and stage where the failure occurred.

Bridge commands

Bridge USDC across blockchains using CCTP.

circle bridge transfer

Bridge USDC from one blockchain to another. Syntax
Arguments Options Example

circle bridge status

Check the status of a bridge transfer by transaction hash. Syntax
Arguments Options Example

circle bridge get-fee

Get the estimated fee for bridging from a given blockchain. Syntax
Arguments Options Example

Gateway commands

Interact with Circle Gateway.

circle gateway balance

Show your Gateway balance for nanopayments. Syntax
Options Examples

circle gateway deposit

Deposit USDC into Circle Gateway for nanopayments. Minimum deposit is 0.5 USDC. Syntax
Options
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.
Example

circle gateway withdraw

Withdraw USDC from Circle Gateway back to a wallet on the same blockchain. Syntax
Options
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.
Examples

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
Options Examples

Transaction commands

Manage pending and submitted transactions.

circle transaction list

List transaction history for a wallet. Syntax
Options Examples

circle transaction cancel

Cancel a pending transaction. Syntax
Arguments Options Example

circle transaction accelerate

Accelerate a pending transaction by increasing the gas fee. Syntax
Arguments Options Example

Contract commands

Interact with onchain contracts.

circle contract address

Show Circle contract addresses, optionally filtered by category and blockchain. Syntax
Arguments Options Examples

circle contract query

Execute a read-only contract call. Syntax
Arguments Options Examples

Skill commands

Discover and install skills from the circlefin/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
Options

circle skill info

Show details and full content for a specific skill. Syntax
Options Example

circle skill install

Install a skill into your agent framework. Syntax
Options Examples

circle skill update

Update installed skills for an agent framework. Syntax
Options

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, use circle 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
Options Examples
JSON output

circle terms accept

Explicitly accept the Terms of Use and Privacy Policy. Use this in scripts and AI agent workflows after the user provides explicit consent. Syntax
Example

circle terms reset

Clear the local acceptance record. The next command run prompts you to accept the Terms again. Syntax

Telemetry commands

Manage CLI telemetry preferences. Telemetry collects privacy-preserving usage data to help improve Circle CLI.

circle telemetry status

Show the current telemetry preference. Syntax
Example

circle telemetry enable

Enable telemetry for future commands. Syntax

circle telemetry disable

Disable telemetry for future commands. Syntax