Rate limits & quotas
The Arch Indexer API enforces per-key rate limits and monthly quotas to ensure reliable service for everyone.
Free plan
- ~25 requests per second per API key.
- ~30M requests per month per account (across keys).
- Reasonable WebSocket usage for realtime subscriptions.
Throttling behavior
When a limit is exceeded, the API responds with HTTP 429:
HTTP 429
{
"error": "rate_limit_exceeded",
"message": "Per-second request limit exceeded for this API key.",
"limit_rps": 25
}For monthly quota exhaustion:
HTTP 429
{
"error": "monthly_quota_exceeded",
"message": "Monthly quota exceeded for this API key.",
"limit_monthly": 30000000
}Best practices
- Implement client-side retries with exponential backoff on 429.
- Spread traffic across a small number of keys rather than many tiny keys.
- Use WebSockets for high-frequency realtime updates instead of polling.