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

Rate Limiting

Your app's requests to the REST API are evaluated per method.
Currently, there is a limit of 10,000 credits for API calls per minute per user per application.

Each REST API method is assigned one of the rate limit weight levels.

WeightCost of one API call
Level 150 credits
Level 2100 credits
Level 3500 credits
Level 42000 credits

If the number of requests exceeds the limit, standard 429 Too many requests error will be returned.

{
    "status": 429,
    "code": "tooManyRequests",
    "message": "Request rate limit exceed",
    "context": null,
    "type": "error"
}

Also, the following HTTP headers are included in every response, allowing you to check your current limitations.

Header NameDescription
X-RateLimit-LimitTotal credits that can be allocated per minute
X-RateLimit-RemainingThe number of credits left for the time window
X-RateLimit-ResetTimestamp (UNIX epoch) for when the credits will be reset