Best Practices

Period Format Standards

Always use these formats for periods:

Rate Limits

• 120 requests per minute
• Batch requests when possible to reduce call volume

Caching Strategy

To minimize API calls:

1. Cache company IDs: Store company_id mappings locally (they don't change)
2. Cache series IDs: Store series structure, refresh weekly
3. Cache fundamentals: Store datapoint values, only refresh after latest_datapoint_created_at changes
4. Cache documents: Full documents rarely change, cache for 30+ days

Authentication

All API requests require Basic Auth:

# Format: base64(email:api_key)
Authorization: Basic YOUR_ENCODED_API_KEY