Skip to main content
To maximize your Experience, Chameleon sets very high limits on the number of total requests and the amount of concurrency we support. At this time enforce rate limiting as such: There are a few possible strategies for rate limiting:
  • The global strategy is applied to all requests with limited exceptions. Currently set to 60-120 requests per minute.
  • The max_concurrent strategy is used to limit based on the maximum concurrent requests. When limiting with this strategy, we subtract and add from an N-sized bucket. We give an X-RateLimit-Limit header with N number of concurrent requests when that limit is reached. Please wait until at least one of the outstanding requests finishes. This strategy will queue for up to 4 seconds to allow other concurrent requests to complete. If no request completes during that initial 4 second wait, a 429 response will be sent.
  • The bucket strategy is used to limit based on the total number of requests. Using this strategy, the bucket window expires after N seconds. We give an X-Ratelimit-Wait header with N number of seconds. This is the number of seconds to pause for until requests can proceed without immediate rate limiting.
Contact us to speak about Changing these limits.
StrategyHeaderExample valuedescription
globalX-Retry-After19Up to N requests can occur per minute. Wait for at least 19 seconds before sending your next request.
max_concurrentX-Ratelimit-Limit4Up to N requests can be “running” at the same time. Wait for at least 1 request to complete before retrying.
bucketX-Ratelimit-Wait12Up to N requests can have started within the time window. Pause for N seconds before retrying your request.

​
HTTP Response

When enforcing rate limiting, both a header and a response body will give you information. 
X-Ratelimit-Wait: 12

{
  "code": 429,
  "messages": ["Rate Limited: Please refer to the API docs https://developers.chameleon.io/concepts/rate-limiting for more information"],
  "wait": 12
}

X-Ratelimit-Limit: 4

{
  "code": 429,
  "messages": ["Rate Limited: Please refer to the API docs https://developers.chameleon.io/concepts/rate-limiting for more information"],
  "limit": 4
}