Rate limit

There is no monthly or daily cap — you can make as many requests as you want over time. The only enforced limit is a fair-use per-second rate limit (sliding window) that protects the platform from abuse.

By default each token gets 20 req/s (1200 req/min sliding window). Bursts above this rate immediately trigger backpressure.

Headers

Every successful response includes:

| Header | Meaning | |---|---| | X-RateLimit-Limit | Cap for the current sliding window | | X-RateLimit-Remaining | Calls left before the next 429 | | X-RateLimit-Reset | UNIX epoch when the window resets |

When you exceed

You receive 429 RATE_LIMIT_EXCEEDED with a Retry-After header (in seconds) indicating when the next request will succeed.

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded.",
    "details": { "retryAfter": 1 },
    "requestId": "req_01HX2K3M4N5P6Q7R8S9T"
  }
}

Raising your limit

Email support@holibras.com.br with your token id and expected throughput. Limits can be raised within minutes for production use cases.