Skip to main content
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.
RouteFreeCasualProEnterprise
/api/v1/content/search33030100
/api/v1/content/top-projects-by-handle13030100
/api/v1/content/top-handles-by-project13030100
/api/v1/projects/search33030100
/api/v1/projects/filter33030100
/api/v1/projects/technical-analysis33030100
/api/v1/projects/mindshare-map11515100
/api/v1/data/virality33030100
/api/v1/data/fundamentals/history33030100
/api/v1/data/fundamentals/snapshot33030100
/api/v1/data/wallets/pnl-leaders23030100
/api/v1/data/wallets/pnl-details33030100
/api/v1/data/wallets/smart-money23030100

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