Rate limits and error handling

darwintIQ enforces rate limits to keep the service reliable.

Rate limits (current)

• 1 request / minute / symbol / token for data-heavy endpoints (Trading Models, Price Data, TrendMatrix, SupRes).
• Burst traffic may return 429 even if your average rate is low.

We may adjust limits over time. If you need higher throughput for a legitimate integration, contact us.

Handling 429

When you receive a 429 Too Many Requests:

• wait until the next minute boundary (or apply exponential backoff)
• keep a per-symbol cache on your side
• avoid polling faster than needed (dashboard refresh every ~60s is sufficient for most users)

Error format

Public /v1/* API endpoints currently return errors as JSON with a top-level error field:

{ "error": "Human readable message" }

Some proxy-backed UI mutation endpoints may also include a message field, but API clients calling the public /v1/* endpoints should rely on the HTTP status code plus error.