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

# Rate Limits

> API rate limiting rules

Each API key is limited to **200 requests per minute**. Limits reset on a rolling window.

## Headers

Every response includes these headers:

| Header                  | Description                             |
| ----------------------- | --------------------------------------- |
| `X-RateLimit-Limit`     | Max requests per window (200)           |
| `X-RateLimit-Remaining` | Requests left in current window         |
| `X-RateLimit-Reset`     | Unix timestamp when the window resets   |
| `Retry-After`           | Seconds to wait (only on 429 responses) |

## When Limited

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

```json theme={null}
{
  "success": false,
  "error": "Rate limit exceeded. Try again in 30 seconds."
}
```

Back off and retry after the `Retry-After` value.

## Best Practices

* Cache stock responses — they don't change every second
* Don't poll aggressively — once every 5 minutes is plenty for stock checks
* Use webhooks or Discord for restock notifications instead of polling