Skip to main content
A production key is strongly recommended. Development keys only have access to a handful of endpoints and will return 403 errors for most of the API.

Riot API rate limits

Rate limits are applied per API key. When exceeded, the API returns a 429 status code and valaw raises RiotAPIResponseError.

Development key limits

  • 20 requests per second
  • 100 requests per 2 minutes

Production key limits

Higher limits that vary by application approval level. See the Riot Developer Portal for your specific limits.

Handling rate limits

Valaw does not automatically retry rate-limited requests — this is intentional so you have full control. Handle 429 responses yourself:

Best practices

Space out requests — avoid making many requests in rapid succession, especially in loops. Cache responses — data like account info and content rarely changes. Store results rather than re-fetching:
Limit concurrency — when making multiple requests at once, use a semaphore:
More information on rate limiting can be found in the Riot API documentation.