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:
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 88
X-RateLimit-Reset: 2026-11-16T00:00:00ZWhen 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.
{
"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"
}