Tokens

The current ratelimits are enforced as such:

• If a route is not listed here it effectively uses the global ratelimit.
• All /canvas endpoints are 60/60s irrespective of authentication.

Unauthenticated Request Ratelimits

• This is when no Authorization header is provided.

Authenticated Request Ratelimits

• This is when the Authorization header is provided.

Premium Ratelimits

• This is when the Authorization header is provided and you have paid for premium. 💖

Handling our ratelimits

To avoid getting ratelimited there are multiple ways to handle this

• You can check one of the following headers:
  • x-ratelimit-limit => Tells you your limit for the timeframe
  • x-ratelimit-remaining => Tells you how many requests are left within with your bucket
  • x-ratelimit-next-available => Tells you when your oldest request expires

If you get ratelimited you'll see the following message:

  {
    "retryAfter": "2025-05-06T22:41:57.406Z",
    "retryAfterMs": 60000,
    "error": "You have been ratelimited."
  }

How our ratelimits work

Some Random API uses a sliding window ratelimit.

Read more about how that works here (opens in a new tab)