Skip to main content
FAPIHub applies two limits to every API key:
  • Rate limit (per minute): the maximum number of requests per minute, per API key. Exceeding it returns 429 rate_limit_exceeded.
  • Quota (per billing period): the total number of requests your plan includes. Monthly quotas reset at the start of each billing period. When the quota is used up, the API returns 402 insufficient_credits.

Limits by plan

Check your plan, limits and remaining quota programmatically with GET /v2/account/usage/. That call is free and doesn’t count against your quota.

What counts against your quota

Retrying after a 429 is free.

When the quota runs out (402)

A used-up monthly or lifetime quota returns 402, not 429:
402
Upgrade your plan, or wait for the next billing period. Don’t retry.

When you exceed the rate limit (429)

429 is only used for the per-minute rate limit. The response includes these headers (they’re sent only on 429 responses): The body also has top-level limit, retry_after and reset_at fields:
429

Handling 429 in code

Wait the number of seconds in Retry-After, then retry:
Python
See Errors for the full retry policy, including 5xx errors and timeouts.