Skip to main content

​
Rate Limit Headers

Every response includes these headers:
HeaderDescription
X-RateLimit-LimitMaximum requests allowed in the current window
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetUnix timestamp when the current window resets
Retry-AfterSeconds to wait before retrying (present only on 429 responses)

​
Handling 429 Responses

{
  "success": false,
  "message": "Too many requests. Please slow down.",
  "moreInfo": "Rate limit exceeded. Retry after 37 seconds."
}
Read the Retry-After header and wait at least that many seconds before retrying. Do not immediately re-send — repeated fast retries prolong the backoff window.