Rate Limits
API rate limits depend on your subscription plan. Limits are applied per API key.
Limits by Plan
| Plan | Requests / minute | Requests / day |
|---|
Rate Limit Headers
Every API response includes headers to help you track your usage:
| Header | Description |
|---|---|
| X-RateLimit-Limit-Minute | Maximum requests allowed per minute |
| X-RateLimit-Remaining-Minute | Requests remaining in the current minute window |
| X-RateLimit-Limit-Day | Maximum requests allowed per day |
| X-RateLimit-Remaining-Day | Requests remaining in the current day |
| X-RateLimit-Reset | Unix timestamp (seconds) when the minute window resets |
Handling Rate Limits
When you exceed the rate limit, the API responds with 429 Too Many Requests. Best practices:
- Implement exponential backoff. Wait and retry with increasing delays (1s, 2s, 4s, etc.).
- Cache responses locally. Market data doesn't change every second — cache assets and prices to reduce requests.
- Monitor the rate limit headers to preemptively slow down before hitting the limit.
- Use bulk endpoints where available instead of making many individual requests.
Next: Assets API Reference →