Docs
Narwhal API documentation
Use one API key for Economics; FX; Spot commodity prices (Gold, Silver, Platinum, Palladium, Copper, WTI crude oil, Brent crude oil); Palm oil; Weekly US gasoline prices (EIA); Weekly US diesel prices (EIA); Monthly commodity benchmarks (World Bank); Daily spot prices (WTI crude oil, Brent crude oil, Natural gas); Yield curves for the US, the UK, Germany, Japan, and Canada; Prediction market odds (Kalshi and Polymarket); Economic release calendars; Public holidays.
Make your first request
Set up an API key, store it as a secret, and request US CPI.
GET /v1/economics/USA/cpiAPI and MCP
Choose how you want to use Narwhal.
Economics API
CPI, inflation, labour, GDP, and trade data from official publishers. Coverage varies by country and indicator.
FX API
Current rates, conversion, and paginated history with a timestamp for every rate.
Public Holidays API
Published public holidays with national, regional, and observed-day scope.
Palmoil API
CPO and FFB prices from Indonesia and Malaysia, with native units and history.
MCP server
The same latest and historical operations for AI tools.
How the API behaves
Data updates, problem responses, and request limits.
Freshness
How releases are checked, stored, and updated.
Read the freshness guideErrors and quota
Problem responses, retries, and request limits.
Read the error guideDeveloper resources
The generated schema and public product changes.