Narwhal API documentation
One key for every Narwhal API, over REST and MCP.
Narwhal serves economic indicators, FX rates, commodity prices, public holidays and company data through one REST API and one MCP server. The same key works for all of them.
Make one request first, then pick the API you need.
Make a request
This request returns the latest US consumer price index. It reads your key from NARWHAL_. The quickstart shows how to get one.
curl --request GET \
--url https://api.narwhalapi.com/v1/economics/USA/cpi \
--header "Authorization: Bearer $NARWHAL_API_KEY"APIs
- Economics APICPI, labour, GDP and trade from official publishers.
- FX APICurrent rates, conversion and history.
- Public holidays APINational, regional and observed holidays.
- Palm oil APICPO and FFB prices from Indonesia and Malaysia.
- Spot metals APIPrecious metals, copper, WTI and Brent.
- Economic release calendarsRelease dates and every published version.
- Predictions APIProbabilities by topic and event, with history.
- Stocks APIPrices, history, company events and valuation ratios.
- Funds APIETF and fund prices, NAV and distributions.
- Crypto APIPrices and history for crypto pairs.
- Company calendars APIDividend and stock split calendars.
- Equity risk premium APIEquity and country risk premiums by country.
- Any series APIWorld Bank and Statistics Canada series by ID.
- Filings referenceStatements, filing lists and 5% holder reports.
- Policy ratesCentral-bank policy rates, reserves and balance sheets.
- Prices streamEnded. Read live prices from the REST routes.
Account and operations
- API keysCreate a key, store it as a secret and send it as a Bearer token.
- Errors and creditsProblem responses, retries and request limits.
- FreshnessHow releases are checked, stored and updated.
- VersioningHow the API changes and what stays stable.
- ChangelogPublic product changes.
- OpenAPIThe generated schema.
Was this page helpful?