Rate limits and error handling
darwintIQ enforces reasonable limits to keep the API stable.
Rate Limits
| Limit Type | Value |
|---|---|
| Authenticated | 1 requests/min per symbol |
| Unauthenticated | blocked |
We recommend using caching in your app (e.g. via Next.js revalidate or local storage) to reduce API calls.
Error Codes
|Status |When |Description| |400| Bad Request| Invalid parameter value Check allowed values.| |422| Unprocessable Entity| symbol is missing or invalid symbol is mandatory.| |429| Too Many Requests| Rate limit exceeded Slow down your requests.| |500| Internal Server Error| Unexpected error Try again later.|
Use proper error handling in your client code to fall back gracefully or retry after a short delay.