Rate 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.

{
  "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.

Get started

Guides

Plan limits

x402 fallback

​Plan limits

​x402 fallback

Plan limits

x402 fallback