Discord limits
Most bot outages users notice come from a few Discord limits. Shardlens measures each one.
| Limit | Value | Where to see it |
|---|---|---|
| First interaction response | 3 seconds | Reliability → response time |
| Interaction token lifetime | 15 minutes for follow-ups | Response timing stops at 15 min |
| Global REST limit | 50 requests per second per bot (interaction endpoints exempt) | Reliability → REST |
| Invalid requests | 10,000 per 10 minutes per IP | Reliability → invalid-request budget |
| Gateway sessions | A daily budget of identifies, shown by GET /gateway/bot |
Reliability → identify budget |
| Webhook events | 204 within 3 seconds; retried for up to 10 minutes |
Growth → user installs |
The 3-second deadline
Section titled “The 3-second deadline”Discord shows “The application did not respond” if an interaction gets no first response (reply, defer, update, modal or autocomplete result) within 3 seconds. Shardlens times each interaction from Discord’s timestamp to the first response and reports p50, p95 and p99 per command, and the share that missed the deadline.
If a command is slow, defer first (interaction.deferReply()) and do the work afterwards. The deadline only applies to
the first response.
The invalid-request budget
Section titled “The invalid-request budget”Every 401, 403 and 429 response counts towards a limit of 10,000 per 10 minutes per IP address. Going over it gets
the IP temporarily banned by Cloudflare, and then every request fails, not just the bad ones. 429s with
X-RateLimit-Scope: shared don’t count.
Shardlens shows how much of the budget the last 10 minutes used. An alert on
invalid_requests_pct above 50% gives you time to react.
Rate limits
Section titled “Rate limits”discord.js queues requests to respect rate limits, so 429s are rare unless several processes share a token or a
shared resource is busy. Shardlens records each request discord.js held back for a rate limit, by route and whether
the global limit was the reason, and counts every 429 response in the REST table and the invalid-request budget.
What Discord doesn’t tell bots
Section titled “What Discord doesn’t tell bots”Some numbers aren’t available to any bot: message views, why a server removed the bot, live member counts without
privileged intents, and the country a user is in (locale is their app language). Shardlens shows what is knowable
and labels approximations.