Rate Limits
API rate limits vary by plan. Limits are enforced on a per-day basis and reset at midnight UTC.Limits by plan
| Plan | Requests/min | Requests/day |
|---|---|---|
| Starter (Free) | 60 | 1,000 |
| Pro | 300 | 50,000 |
| Enterprise | Custom | Unlimited |
Rate limit headers
Every API response includes rate limit headers:| Header | Description |
|---|---|
X-RateLimit-Limit | Your daily request limit |
X-RateLimit-Remaining | Requests remaining today |
X-RateLimit-Reset | Unix timestamp when the limit resets (midnight UTC) |
X-Tier | Your current plan tier |
Handling 429 responses
When you exceed the rate limit, the API returns a429 Too Many Requests status with a Retry-After header.
Best practices
Respect the Retry-After header
Respect the Retry-After header
The
Retry-After header tells you how many seconds to wait before retrying. Implement exponential backoff.Cache responses
Cache responses
Market data doesn’t change between snapshots. Cache responses for the snapshot interval (e.g., 5 minutes for 5m markets).
Use pagination wisely
Use pagination wisely
Fetch only the data you need. Use
limit and offset to paginate through large result sets.Monitor your usage
Monitor your usage
Check your usage in the Dashboard or read the rate limit headers.