# Rate limits

Synth API enforces rate limits based on your subscription plan.

## Limits by Plan

| Plan         | Requests/Minute | Requests/Day |
| ------------ | --------------- | ------------ |
| Professional | 20              | 1,000        |
| Enterprise   | Custom          | Custom       |

## Response Headers

Every response includes rate limit information:

```http
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1738329660
```

## Handling Rate Limits

When you exceed the limit, you'll receive `429 Too Many Requests`:

```json
{
  "error": "Rate limit exceeded",
  "message": "Please try again in 42 seconds",
  "retry_after": 42
}
```

### Retry Logic

{% code title="example.py" %}

```python
import time
import requests

def make_request_with_retry(url, headers):
    response = requests.get(url, headers=headers)
    
    if response.status_code == 429:
        retry_after = int(response.headers.get('Retry-After', 60))
        time.sleep(retry_after)
        return make_request_with_retry(url, headers)
    
    return response.json()
```

{% endcode %}

## Best Practices

* Cache responses — Predictions don't change frequently.
* Batch requests — Use the `limit` parameter to get multiple miners.
* Monitor usage — Check headers on every response.
* Implement backoff — Use exponential backoff for retries.

## Next Steps

* [View pricing](broken://pages/3d911d70dd3c6fe8e8e6640a6805234fe8bdf2fe)
* [Handle errors](broken://pages/881681ff5db1046d1ddbd1f8bc1ecc181dca7c8a)


---

# 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.synthdata.co/getting-started-old/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.