Skip to main content
The Usage Limit Policy restricts how many times your agent can execute a specific action. Simple but effective rate limiting.

When to Use Usage Limit

Subscription agents (12 payments per year)
Trial periods (limited actions)
Preventing runaway agents
Metered access models
Safety cap for any automation

Basic Usage

Agent Examples

Subscription Agent (12/Year)

Trial Agent (10 Actions)

Rebalancing Agent (Quarterly)

Gaming Agent (Action Budget)

Metered Access

Sell action packs:

Combining with Other Policies

Usage + Time (Most Common)

Usage + Universal Action

Usage renewal: When usage limits are reached, the onchain actions will be reverted. Need to enable a fresh session for the user.

Limits

  • usageLimit is a bigint
  • Maximum value: 2^256 - 1 (effectively unlimited)
  • Counter decrements atomically per successful execution
  • Failed executions don’t count against limit