# Rate-limits

## Specification

To keep our service and its performance active, online and secure for everybody - we impose strict rate limiting rules for users. Our reset time frame is around 60 seconds, all users will be able to send a designated number of requests per time frame. Once you've exceeded the per-minute quota, all requests to our API will be declined with a 429 Too Many Requests response.

## Headers

We use (what is deemed as) standard headers to inform the client of a rate limit.

| Header                  | Value Type | Description                                                                                                   |
| ----------------------- | ---------- | ------------------------------------------------------------------------------------------------------------- |
| `X-Ratelimit-Limit`     | Number     | The number of requests a client can make to our API in the time frame before hitting rate limits.             |
| `X-Ratelimit-Remaining` | Number     | The number of requests a client has left before hitting rate limits.                                          |
| `X-Ratelimit-Reset`     | Number     | The number of seconds a client has left before the time frame and rate limit counter is reset.                |
| `X-Retry-After`         | Number     | The number, in seconds, in which how long a client should wait before re-trying to make any further requests. |
