Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nordicfinancialnews.com/llms.txt

Use this file to discover all available pages before exploring further.

All API endpoints require Bearer token authentication using an API key.

How to authenticate with API keys

Include your API key in the Authorization header on every request:
Authorization: Bearer YOUR_API_KEY
Generate API keys from Settings > API Keys in your Nordic Financial News account.

API key scopes and permissions

API keys use scope-based access control. All scopes are enabled by default:
ScopeAccess
readAll content (articles, stories, companies, categories, countries, exchanges, indices, sources, search)
read:watchlistRead your watchlists and their companies
You can restrict scopes when creating an API key to limit access.

Rate limits and usage quotas

The API enforces hourly rate limits and monthly usage quotas per API key. Your current limits and usage are visible in your API key settings.

Rate limit headers

Every response includes headers so you can track usage proactively:
HeaderDescription
X-RateLimit-LimitMaximum requests per hour
X-RateLimit-RemainingRequests remaining this hour
X-RateLimit-ResetSeconds until the hourly limit resets
X-Monthly-LimitYour plan’s monthly allowance
X-Monthly-RemainingRequests remaining this month
X-Monthly-ResetISO 8601 timestamp when the monthly limit resets
When either limit is exceeded, the API returns 429 Too Many Requests with a Retry-After header. See error handling for details on handling 429 responses.
304 Not Modified responses from ETag caching do not count against your monthly quota.
Last modified on April 18, 2026