> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rxscale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Rate Limits

> API rate limiting and best practices

# Rate Limits

All RxScale APIs enforce rate limits to ensure fair usage and system stability.

## Default Limits

| Limit               | Value |
| ------------------- | ----- |
| Requests per second | 10    |
| Requests per minute | 600   |

## Rate Limit Response

When you exceed the rate limit, the API returns:

```json theme={null}
{
  "error": "Rate limit exceeded"
}
```

**HTTP Status:** `429 Too Many Requests`

## Best Practices

* **Use webhooks** instead of polling for real-time updates. Register webhook subscriptions to receive notifications when orders or stock levels change.
* **Cache responses** where appropriate. Product catalogs and SKU lists change infrequently.
* **Implement exponential backoff** when you receive `429` responses. Wait, then retry with increasing intervals.
* **Batch operations** when possible rather than making individual requests for each item.