Rate Limits
The Conviction Public API applies rate limits to ensure service stability and fair access for all users.
Current Limits
| Tier | Rate Limit | Description |
|---|---|---|
| Public | 100 requests / 10 seconds | Default for all unauthenticated requests |
Rate Limit Headers
Responses include rate limit information in headers:
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests per window |
X-RateLimit-Remaining | Remaining requests in current window |
X-RateLimit-Reset | Unix timestamp when the window resets |
Exceeding Rate Limits
When you exceed the rate limit, the API returns a 429 Too Many Requests response:
{
"statusCode": 429,
"message": "Too many requests, please try again later"
}
Best Practices
- Cache responses when possible
- Use
limitandoffsetto paginate rather than fetching all data at once - Avoid polling more frequently than necessary — consider using webhooks (coming soon)