Rate Limits
ChartInspect API quotas, response headers, request bounds, and retry guidance.
Rate limits are tracked per API key in hourly and daily windows.
#Default Quotas
| Tier | Hourly | Daily |
|---|---|---|
| Free | 100 | 1,000 |
| Pro | 1,000 | 20,000 |
| Enterprise baseline | 10,000 | 200,000 |
Enterprise quotas can be customized within the platform cap. The values attached to the key are authoritative.
#Response Headers
Authenticated responses expose the current windows when rate-limit context is available:
| Header | Meaning |
|---|---|
X-RateLimit-Remaining-Hourly | Requests remaining in the hourly window |
X-RateLimit-Remaining-Daily | Requests remaining in the daily window |
X-RateLimit-Reset-Hourly | ISO 8601 time when the hourly window resets |
X-RateLimit-Reset-Daily | ISO 8601 time when the daily window resets |
#Request Bounds
Common time-series parsers cap days at 3,650 and limit at 10,000. Individual endpoints may expose a narrower parameter set or lower source-specific bounds. The generated reference lists only the parameters advertised for each endpoint.
#When Limited
A limited request returns HTTP 429. Stop sending requests until the relevant reset time, then retry with exponential backoff and jitter. Do not retry 400, 401, 403, or 404 responses as if they were rate limits.
Reduce request volume by caching immutable history, requesting only the needed date range, projecting fields where supported, and using the live stream instead of polling when market ticks are required.