Authentication
Most Claudius API endpoints are public and do not require authentication. Rate limits apply to all requests.
Rate Limits
Public endpoints are rate-limited per IP. Cached responses return quickly; fresh fetches may take longer depending on the data source.
| Endpoint Type | Cache | Notes |
|---|---|---|
| Stock prices | No cache (live) | Yahoo Finance real-time |
| Macro / commodities | 5-30 min | Use ?fresh=true to bypass |
| Scanner | 15 min refresh | Rate-limited refresh |
| Research | None | AI-generated, takes 30-60s |
| Memoria | No cache | User-scoped (auth required for write) |
Response Format
All endpoints return JSON. Errors follow this format:
{
"error": "Description of what went wrong"
}Cross-Origin
All endpoints support CORS. You can call them directly from browser-based apps.