Discord Rate Limits
Global Rate Limit
Each hosting account is limited to 250 requests per minute to the Discord API. This threshold can be increased if needed by contacting our team on our Discord server.
Error Rate Limit
In addition to the global limit, limitations are applied to the number of failed requests. If the Discord API responds with more than 25 failed requests in less than a minute, your bot will not be able to send any more requests to the Discord API for 2 minutes and 30 seconds.
Rate Limit Summary
| Global Rate Limit | Error Rate Limit | Webhook Rate Limit | |
|---|---|---|---|
| Requests | 250 | 25 | 25 |
| Time Window | 60s | 60s | 60s |
| Block Duration | Sliding | 180s | Sliding |
INFO
These thresholds are suitable for 99% of our users, without causing them any problems.
What is a "Sliding" Block?
A sliding block means the rate limit window moves with each request. As long as you're under the threshold within any 60-second window, your requests will go through normally.
Need a Higher Limit?
If your bot legitimately needs more than 250 requests per minute, contact our team on Discord to discuss increasing your threshold.
Best Practices
- Implement proper error handling for rate limit responses (HTTP 429)
- Use caching to reduce unnecessary API calls
- Batch operations when possible
- Avoid polling — use gateway events instead