These docs are for v2.0. Click to read the latest docs for v2.1.

Rate Limits

By default you can make up to 120 requests per minute.

Rate limit information is returned in the HTTP headers of any API request:

X-Api-Ratelimit-Limit: 120
X-Api-Ratelimit-Limit-Remaining: 19
X-Api-Ratelimit-Reset: 1461247812

Use these headers to understand how your requests are being limited:

HeaderDescription
X-Api-Ratelimit-LimitThe maximum number of requests per minute that you can make.
X-Api-Ratelimit-Limit-RemainingThe number of requests remaining in the current rate limit window.
X-Api-Ratelimit-ResetThe Unix time at which the rate limit will reset to its maximum.

If your application triggers this rate limit, you'll receive the following response:

HTTP/1.1 429 Too Many Requests
Content-Type: application/json; charset=utf-8

{
  "error": {
    "msg":"Too many API requests. See documentation for more information",
    "name":"exceeded_rate"
  }
}

📘

Questions about the API rate limit?

If the current API rate limit is not sufficient for your use cases, please contact [email protected]. We can help you optimize your current usage and discuss alternative options.