Rate limits

Backoff: Use exponential backoff on 429.
Monitor: Watch the rate-limit headers.
Cache: Avoid repeat requests for data that rarely changes.

Firmium rate-limits the API to keep usage fair and the system stable. Every request counts against your limit.

Overview

Default for authenticated users: 100 requests per minute (plan-dependent).
Current values are sent in X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset.

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 12
X-RateLimit-Reset: 1712345678

{
  "error": "Rate limit exceeded. Please try again later.",
  "limit": 100,
  "reset_in": 42,
  "reset_at": "12:34:56"
}