Authentication

Kanarie API uses Bearer API-key authentication for API requests:

Authorization: Bearer YOUR_API_KEY

The x-kanarie-api-key: YOUR_API_KEY header is also supported for current clients. Include the key on every authenticated request.

curl "https://api.kanarie.xyz/api/v1/projects/search?type=name&q=Jupiter" \
  -H "Authorization: Bearer YOUR_API_KEY"

Droyd API keys are no longer accepted by the Kanarie API.

Playground auth

In the API reference, paste your key into the auth field. Mintlify will include the header when you click Send.

Common authentication failures:

Status	Cause
`401`	Missing, malformed, invalid, revoked, or expired API key on API-key-only paths
`402`	x402 payment is required for no-key requests, failed API-key requests, or over-limit API-key requests on x402-enabled paths
`429`	Rate limit exceeded on API-key-only paths

Valid API keys without an active paid subscription use the free tier limits.

Kanarie has an internal service-key path for trusted backend calls. It is not part of the public API and is intentionally excluded from public docs.