Skip to main content
The Timeframe Policy restricts when your agent can execute actions. Essential for scheduled automation, temporary access, and timebounded safety limits.

When to Use Timeframe

Subscription payments
Trial periods for new users
Scheduled automation (run only at specific times)
Combining with Sudo for safety

Basic Usage

Agent Examples

Subscription Agent (Monthly Windows)

Only allow payments once per month for a year

Trial Agent (7-Day Trial)

Limited access for evaluation:

Yield Optimizer (Quarterly Rebalancing)

Restrict to specific rebalancing windows:

Delayed Start

Start permissions in the future:
Use cases:
  • Scheduled launches
  • Vesting schedules
  • Delayed automation

Combining with Other Policies

Timeframe works best combined with other restrictions:

Time + No other restrictive policies

Time + Usage Limit

Time + Universal Action

Time Format

All timestamps are Unix timestamps in seconds (not milliseconds):

Helper Functions