API documentation

REST, JSON-RPC and WebSockets for Arch blocks, transactions, accounts, programs and tokens.

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.