# Rate Limiting & Usage

To ensure fair usage and system stability, API requests are rate-limited based on your **Nabzclan VIP Tier**.

## Daily Limits

| Plan Tier | Daily Requests |
|-----------|---------------|
| **Free** | 100 |
| **VIP 1** | 5,000 |
| **VIP 2** | 10,000 |
| **VIP 3** | 20,000 |
| **VIP 4** | **Unlimited** |

## Unlimited Request Policy

If you are on the **VIP 4** plan, your `limit` and `remaining` fields in API responses will return `-1`. This indicates that no hard limit is enforced.

## Headers

Every response includes headers describing your current rate limit status:

- `X-RateLimit-Limit`: Your daily limit (or empty/high number if unlimited).
- `X-RateLimit-Remaining`: Requests remaining in the current window.
- `Retry-After`: Seconds to wait if limit is exceeded (HTTP 429).

## Exceeding Limits

If you exceed your daily limit, the API will return a `429 Too Many Requests` error:

```json
{
    "error": "rate_limit_exceeded",
    "message": "Daily request limit exceeded. Please upgrade your plan."
}
```