Skip to main content
Spending policies cap the USDC and EURC your agent wallet moves and restrict the wallet to specific recipient or contract addresses. When a policy applies, Circle rejects requests that exceed a limit or violate an address rule. Policies apply to mainnet agent wallets only. When no custom transfer limit applies, the default limit is 100 USDC per month. For the recommended setup, set a global transfer limit, then add a contract allowlist on every blockchain your agent uses.

Prerequisites

Before you begin, ensure that you’ve: Use Circle CLI 1.4.0 or later to set, view, or reset global transfer limits. Run circle update to update your CLI.
Spending policies require a mainnet agent wallet. Testnet is not supported. Setting a policy triggers a second email OTP to confirm the change. The OTP is used once and not stored.
Choose the policy type that matches your goal.

Setup

Transfer limits cap the USDC and EURC your agent moves through Circle. A global limit applies on every supported Ethereum Virtual Machine (EVM) mainnet, but it doesn’t restrict which contracts your agent calls. Pair it with a contract allowlist on the Allowlists and blocklists tab.Token approvals count at their full amount when submitted, so a swap or bridge counts once, at its approval step. Approve only the amount each spender needs.

Steps

1

Set the limits

Run circle wallet limit set without --chain to set a global limit. All four caps are required: per-transaction, daily, weekly, and monthly.
Circle sends an email OTP to your agent session email to confirm the policy change. Limits must satisfy: per-transaction ≤ daily ≤ weekly ≤ monthly.To set a limit for one blockchain, add --chain ARC. When global and blockchain limits both apply, the stricter value wins for each cap. A blockchain with neither limit uses the 100 USDC monthly default.circle wallet limit set creates a new rule and fails if that rule already exists in the same scope. To change an existing limit, run circle wallet limit reset for that scope first.
2

Verify the policy

View the global limit, then check the limits on Arc:
Check Scope to see if a rule covers All EVM chains or one blockchain. Check Origin for CUSTOM or DEFAULT.
See the CLI command reference for full syntax and options.