API Documentation

"All systems charged"

- Ezreal

API Keys

Anyone who signs into the developer portal will automatically be granted an API key associated with their account. If you haven't yet done so, please visit the Getting Started page for more information. Your API key allows you to start using the API, and allows us to generate API usage metrics for your key.

Development and Interim API Keys

The API key that was generated for you when you signed into the developer portal is a development API key. Interim API keys are temporarily granted for projects that are not meant for public consumption but do require temporary access to the API. The purpose of a development or interim API key is for you to tinker with the Riot Games API and potentially develop a prototype for a project that you can make available for the community to use.

Other acceptable uses for a development API key include:

  • bots for streaming sites, boards, voice com servers, etc.
  • to display your own personal stats for your personal website
  • personal projects to gather your own stats
  • personal research
  • projects meant for personal usage and not production

The rate limit for development keys is by design very limited:

  • 10 requests every 10 seconds
  • 500 requests every 10 minutes
Note that rate limits are enforced per region. For example, with the above rate limit, you could make 10 requests every 10 seconds to both NA and EUW endpoints simultaneously.

You can find your development API key and its rate limit on your dashboard. In addition, the metrics we generate for your key allow you to track your key's usage under the Development API Key Usage section on your dashboard. Note that these graphs will include all calls made with your API key, even those that don't count against your rate limit (e.g., calls to the static data API). For more information on rate limits, see the Rate Limiting documentation.

Production API Keys

If you have developed an application that you would like to open up to use by the community, you should apply for a production API key. You should not try to maintain a public application or website off of a development API key. Production API keys have a much higher rate limit suitable for sustaining a production application's traffic.

The standard rate limit of a production API key is much larger than the development key:

  • 3,000 requests every 10 seconds
  • 180,000 requests every 10 minutes
Remember that this rate limit is enforced per region.

To apply for a production key with an expanded rate limit, click on the "Register Project" button on your dashboard, then fill out and submit the form. The process and length of time required to obtain an approved production key can vary depending on your project and the application's target region(s). It's best to apply for a production API key as soon as you have a functional application, so we can get a better idea of what you're working on and facilitate a speedy application process. For more information on policies and process, see the General Policies and Application Process documentation.

Note that the standard production rate limit will meet the needs of the large majority of developers but it can be expanded if the developer is in good standing, has demonstrated a strong community benefit, and has steadily outgrown the standard production limit.

If you are working on multiple projects, you should register each one separately and each one needs to be individually approved for a separate production API key.

Production API keys are only granted to projects that are available, visible, and usable by the community and comply with our General Policies.

If you have an approved production application, you can click on that application from your dashboard to view the application details page, which will display the rate limit for that application's key. In addition, the metrics we generate for your key allow you to track your key's usage under the API Key Usage section on the application details page. Note that these graphs will include all calls made with your API key, even those that don't count against your rate limit (e.g., calls to the static data API). For more information on rate limits, see the Rate Limiting documentation.

Security

It's important to mention that any key may be revoked if it isn't being properly secured. Securing your API key is a requirement to publishing an project as outlined in the General Policies. For more information on securing your API key, please see the Credentials Security page.