Skip to content
Docs / Rate limits

Rate limits

Limits count tool calls, not tokens. A typical screen takes three to six calls, so the free tier covers a full day of normal building.

Limits by plan

Free
Per day 300 · per minute 20
Resets at 00:00 UTC
Pro
Per day Unlimited · per minute 60 per key
Fair use
Team
Per day Unlimited · per minute 60 per key
Fair use, per seat

Headers

Every HTTP response carries your remaining budget:

Response headers
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 88
X-RateLimit-Reset: 2026-11-16T00:00:00Z

When you hit a limit

The tool returns 429 rate_limited with a message the agent can read and repeat, including when the limit resets. Nothing else breaks: your agent keeps working, just without Astron, until then.

Responsejson
{
  "error": "rate_limited",
  "message": "Free plan limit of 300 calls reached. Resets at 00:00 UTC, or upgrade to Pro for unlimited calls.",
  "reset": "2026-11-16T00:00:00Z"
}