Skip to main content

Rate Limits

Elfa applies request-rate limits and credit limits by access model. Use this page when sizing an integration, configuring retry behavior, or deciding between API key and x402 access.

API Key Limits

PlanRequests per minuteMonthly credits
Free60 RPM1,000
Chill60 RPM5,000
Grow120 RPM40,000
PAYG60 RPMUsage-based
EnterpriseCustomCustom

API key limits apply per key. Subscription credits reset monthly. PAYG keys have no monthly allocation and are billed per credit consumed.

x402 Limits

x402 pay-per-request access currently supports 1,000 RPM. Each request carries payment headers and is charged in USDC per call or per credit consumed by the endpoint.

For x402-specific safeguards and retry guidance, see x402 Rate Limits.

Handling Limits

When an integration receives an HTTP 429 rate-limit response:

  1. Honor Retry-After when present; otherwise start with a short delay and increase exponentially.
  2. Reuse cached responses when freshness requirements allow it.
  3. Avoid parallel duplicate calls for the same symbol, account, or time window.
  4. Track credit usage and request rate per API key, wallet, or agent identity.