Skip to main content

Rate Limit

The API has a rate limit of 100 requests per minute. If you exceed this limit, you will receive a 429 status code.

Rate Limit Headers​

The API returns the following headers to help you manage your rate limit:

  • X-Rate-Limit-Limit: The maximum number of requests you can make per minute.
  • X-Rate-Limit-Remaining: The number of requests you have left for the current minute.
  • X-Rate-Limit-Reset: The time at which the rate limit will reset, in seconds.

Example​

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
X-Rate-Limit-Limit: 100
X-Rate-Limit-Remaining: 0
X-Rate-Limit-Reset: 60

How to handle rate limit errors​

When you receive a 429 Too Many Requests status code, you should wait until the rate limit resets before making another request. You can use the X-Rate-Limit-Reset header to determine when the rate limit will reset.

Rate Limit Exceeded​

If you exceed the rate limit, you will receive a 429 Too Many Requests status code. The response will include the following headers:

  • X-Rate-Limit-Limit: The maximum number of requests you can make per minute.
  • X-Rate-Limit-Remaining: The number of requests you have left for the current minute.
  • X-Rate-Limit-Reset: The time at which the rate limit will reset, in seconds.

Rate Limit Reset​

The rate limit will reset at the time specified in the X-Rate-Limit-Reset header. You should wait until this time before making another request.

Rate Limit Remaining​

The X-Rate-Limit-Remaining header tells you how many requests you have left for the current minute. If this number is 0, you have exceeded the rate limit and should wait until the rate limit resets.

Rate Limit Limit​

The X-Rate-Limit-Limit header tells you the maximum number of requests you can make per minute. If you exceed this limit, you will receive a 429 Too Many Requests status code.