Documentation Index
Fetch the complete documentation index at: https://developers.circle.com/llms.txt
Use this file to discover all available pages before exploring further.
Spending policies let you cap your agent wallet’s USDC transfers over a rolling
time window, or restrict the wallet to specific recipient or contract addresses.
Policies apply to mainnet agent wallets only.
Prerequisites
Before you begin, ensure you have:
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.
Steps
Choose the policy type that matches your goal.
Set the limits
Run circle wallet limit set with per-transaction, daily, weekly, and
monthly caps:circle wallet limit set \
--address 0xYourWalletAddress \
--chain BASE \
--policy-type stablecoin \
--per-tx 100 \
--daily 500 \
--weekly 2000 \
--monthly 5000
Verify the policy
Confirm the limits are in effect:circle wallet limit --address 0xYourWalletAddress --chain BASE
Allowlists and blocklists restrict your wallet to specific recipient or
contract addresses.Set the rule
Run circle wallet limit set with --rule-type and a bracketed,
comma-separated --targets list of EVM addresses. The example below
blocks transfers to two recipient addresses:circle wallet limit set \
--address 0xYourWalletAddress \
--chain BASE \
--policy-type stablecoin \
--rule-type recipient-blocklist \
--targets "[0xBAD1,0xBAD2]"
--rule-type accepts:
recipient-allowlist / recipient-blocklist: allow or block USDC
transfers to specific addresses.contract-allowlist / contract-blocklist: allow or block contract
interactions with specific addresses.
Circle sends an email OTP to your agent session email to confirm the
policy change. Verify the policy
Confirm the rule is in effect:circle wallet limit --address 0xYourWalletAddress --chain BASE
