Rate Limits
Usage quotas and throttling
API rate limits ensure fair usage and system stability.
Rate Limit Tiers
| Tier | Per Minute | Per Day |
|---|---|---|
| Default | 60 requests | 10,000 requests |
| Verified | 120 requests | 50,000 requests |
| Partner | 300 requests | 100,000 requests |
Rate Limit Headers
Every API response includes headers with your current rate limit status:
X-RateLimit-Limit |
Maximum requests per minute |
X-RateLimit-Remaining |
Requests remaining in current window |
X-RateLimit-Reset |
Unix timestamp when the limit resets |
Handling Rate Limits
When you exceed the rate limit, you'll receive a 429 Too Many Requests response:
{
"error": "rate_limit_exceeded",
"error_description": "Too many requests. Please retry after 60 seconds.",
"retry_after": 60
}