Skip to main content

Two Types of Limits

Ardie enforces two types of limits on API usage:
  1. Rate Limits — Requests per minute
  2. Usage Caps — Total queries per billing period

Rate Limits

To ensure fair usage and system stability, API requests are rate-limited:
Rate limits are applied per API key, not per account. If you have multiple keys, each has its own rate limit.

Rate Limit Headers

Every response includes headers showing your rate limit status:

Rate Limit Exceeded

When you exceed the rate limit:
Best practice: Implement exponential backoff when you receive a 429 response.

Usage Caps

Your plan includes a fixed number of queries per billing period. This is a hard cap—when reached, requests are rejected until the next period or you upgrade.

Checking Your Usage

Monitor usage via the Dashboard or check the response headers:

Cap Exceeded Response

When you hit your query cap:

Handling Limits in Code

Next Steps

Error Handling

Handle all error types gracefully

Pricing Plans

Upgrade for more queries