# Rate limits

{% hint style="info" %}

#### Hard limit

Our API has a global user rate limit of 60 requests per minute. This means that a maximum of 60 requests can be sent at 1 minute intervals using the same API key.
{% endhint %}

### Rate limits

If you exceed your rate limit you will receive a 429 error response with a "Too Many Attempts" message. If you think you will be hitting these limits, please implement a backoff strategy that would even out the requests over time.

```http
Response Code: 429 Too Many Requests
Content-Type: application/json
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
```

```json
{
  "message": "You've exceeded the request limit."
}
```

### Rate limit headers

Each API request comes back with headers related specifically to rate limiting.

<table><thead><tr><th width="278">Header</th><th>Meaning</th></tr></thead><tbody><tr><td><code>X-RateLimit-Limit</code></td><td>The maximum number of API requests that the user can make per minute.</td></tr><tr><td><code>X-RateLimit-Remaining</code></td><td>The remaining number of API requests that the user can make per minute.</td></tr><tr><td><code>X-RateLimit-Reset</code></td><td>A timestamp indicating when the remaining limit resets.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ocoya.com/fundamentals/rate-limits.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.