Skip to content

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

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.

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.

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.

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.