Skip to main content

Bucketmap

Know how Discord rate limits every REST route, and check that your proxy does the same.

Bucketmap is two tools:

  • An index of the 314 Discord REST routes a bot can reach, with what is known of their rate limit: which parameter splits their counters, whether they count toward the global limit, how their bucket refills, and which routes share it.
  • An engine that walks a test guild through those routes with a few requests each, and reports what every route answered and which bucket it fell in. Run it against Discord, then against your proxy, and compare.

Useful if you write a Discord library, run a REST proxy in front of Discord (like our Nirn Proxy), build a Discord simulator, or just want to know how a route is limited.

Get started​

License​

Bucketmap is released under the AGPL v3 license with a linking exception: using it as a library, or running it against your own API, proxy or bot, imposes nothing on your code. Changes to Bucketmap itself, used publicly, must be published under the AGPL v3. The source code is on GitHub.