What is Rate Limiting?#
Rate limiting controls how many API requests you can make within a specific time period. This ensures fair usage and optimal performance for all users.
Default Limits#
All stores start with a default limit of 60 requests per minute.This means you can make up to 60 API calls every minute. After reaching this limit, you'll need to wait until the next minute to make more requests.
How It Works#
Time Window#
Rate limits are calculated per 1-minute window
The counter resets automatically every minute
Example: If you make 60 requests between 14:30:00 and 14:30:59, you can make another 60 from 14:31:00 onwards
Request Counting#
Each successful API call counts toward your limit. When you reach your maximum, any additional requests within that minute will be rejected with an error.
Every API response includes information about your current rate limit status:X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42
X-RateLimit-Window: 1m
X-RateLimit-Reset: 1699455660
X-RateLimit-Limit: Your maximum allowed requests per minute
X-RateLimit-Remaining: How many requests you have left in this minute
X-RateLimit-Window: Time window duration (always 1 minute)
X-RateLimit-Reset: Unix timestamp when your counter resets
Rate Limit Exceeded#
When you exceed your rate limit, you'll receive this response:{
"success": false,
"msg": "Rate limit exceeded. Please slow down.",
"code": "RATE_LIMIT_EXCEEDED",
"max_requests": 60,
"window": "1 minute(s)",
"retry_after": 60
}
What to Do#
1.
Wait for the time specified in retry_after (in seconds)
2.
Check the X-RateLimit-Reset header to know when your limit resets
3.
Implement proper rate limiting in your application
Modified at 2025-11-08 13:50:29
