Authentication
API keys and the X-API-Key header.
Every /api/v1 request authenticates with an API key in the X-API-Key header.
curl -H "X-API-Key: flk_your_key" https://api.financelab.ai/api/v1/newsKeys
- Create and revoke keys in your dashboard.
- The secret (prefixed
flk_) is shown once at creation; store it securely. We keep only a hash. - A missing, malformed, or revoked key returns
401 Invalid or missing API key.
Rate limits
Each key is limited to 60 requests per minute. Exceeding it returns 429 with a Retry-After
header. Back off and retry.
Tiers
Free keys query the last 30 days and include 1,000 requests per month; Pro keys get
full point-in-time history and unlimited monthly requests. When a free key requests a range
beyond the 30-day window, the response clamps the range and adds a note (the request still
succeeds). See Tiers.