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

# Rate limits

> Understand Kanarie API rate-limit windows and plan limits.

Rate limits are scoped by API key and route. All plans have a 15-minute window.

Free-tier API keys also have a UTC-weekly route limit set to `10x` the 15-minute free limit.

When a request exceeds a route limit on an x402-enabled endpoint, Kanarie returns the x402 payment-required flow. API-key-only paths return `429` with the limit, plan, window, and retry interval.

```json theme={null}
{
  "error": "Rate limit exceeded",
  "limit": 30,
  "plan": "casual",
  "window": "15 minutes",
  "retryAfter": 900
}
```

## Plan limits

These are 15-minute limits. Free weekly limits are `10x` the listed free limit.

| Route                                    | Free | Casual | Pro | Enterprise |
| ---------------------------------------- | ---: | -----: | --: | ---------: |
| `/api/v1/content/search`                 |    3 |     30 |  30 |        100 |
| `/api/v1/content/top-projects-by-handle` |    1 |     30 |  30 |        100 |
| `/api/v1/content/top-handles-by-project` |    1 |     30 |  30 |        100 |
| `/api/v1/projects/search`                |    3 |     30 |  30 |        100 |
| `/api/v1/projects/filter`                |    3 |     30 |  30 |        100 |
| `/api/v1/projects/technical-analysis`    |    3 |     30 |  30 |        100 |
| `/api/v1/projects/mindshare-map`         |    1 |     15 |  15 |        100 |
| `/api/v1/data/virality`                  |    3 |     30 |  30 |        100 |
| `/api/v1/data/fundamentals/history`      |    3 |     30 |  30 |        100 |
| `/api/v1/data/fundamentals/snapshot`     |    3 |     30 |  30 |        100 |
| `/api/v1/data/wallets/pnl-leaders`       |    2 |     30 |  30 |        100 |
| `/api/v1/data/wallets/pnl-details`       |    3 |     30 |  30 |        100 |
| `/api/v1/data/wallets/smart-money`       |    2 |     30 |  30 |        100 |

## x402 fallback

For endpoints that support x402, over-limit API-key requests fall through to x402 payment. This applies to both free and paid plans.