API reference

API references 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.

Choose an API

Live · 20 operations · 36 countries

Economics API

CPI, inflation, labour, GDP, and trade data from official publishers. Coverage varies by country and indicator.

Open the reference Coverage Methodology

Live · Current · conversion · history

FX API

Current rates, conversion, and paginated history with a timestamp for every rate.

Open the reference Coverage Methodology

Live · Yearly · on a date · next holiday

Public Holidays API

Published public holidays with national, regional, and observed-day scope.

Open the reference Coverage Methodology

Live · 3 operations

Palmoil API

CPO and FFB prices from Indonesia and Malaysia, with native units and history.

Open the reference Coverage Methodology

Calendars · live public beta

Published country-years are available with your Narwhal key. Other coverage is explicitly unavailable. Read the three calendar operations and coverage limitations.

Shared basics

Every data request needs a Bearer key.
REST and MCP use the same account quota.
Dates, units, currencies, and freshness stay in the response.
Errors use one problem shape with a request_id.

REST starts at https://api.narwhalapi.com/v1. MCP is at https://api.narwhalapi.com/mcp.