Euro Exchange Rates by ECB

Retrieve Euro foreign exchange reference rates from an API provided by the European Central Bank. This module is intended to run on the server via Node.js, not in the browser.

The API provides exchange rates updated daily for the following currencies:

• USD: US dollar
• JPY: Japanese yen
• CZK: Czech koruna
• DKK: Danish krone
• GBP: Pound sterling
• HUF: Hungarian forint
• PLN: Polish zloty
• RON: Romanian leu
• SEK: Swedish krona
• CHF: Swiss franc
• ISK: Icelandic krona
• NOK: Norwegian krone
• TRY: Turkish lira
• AUD: Australian dollar
• BRL: Brazilian real
• CAD: Canadian dollar
• CNY: Chinese yuan renminbi
• HKD: Hong Kong dollar
• IDR: Indonesian rupiah
• ILS: Israeli shekel
• INR: Indian rupee
• KRW: South Korean won
• MXN: Mexican peso
• MYR: Malaysian ringgit
• NZD: New Zealand dollar
• PHP: Philippine piso
• SGD: Singapore dollar
• THB: Thai baht
• ZAR: South African rand

Installation

$ npm install ecb-euro-exchange-rates

Usage

TS typings are available and you’ll get auto-completion for the supported currencies.

import * as exchangeRates from 'ecb-euro-exchange-rates';

const result = await exchangeRates.fetch();
console.log('Last update: ' + result.time);
console.log('USD: ' + result.rates.USD);

Historic rates are available via fetchHistoric90d (fetches previous 90 days) and fetchHistoric (fetches all rates back to 1999).

Historic responses do not always carry the same currencies as the daily one: they may include currencies the ECB has since stopped publishing (HRK and RUB, for example), and they omit currencies that were not yet published at the time — the oldest entry, from January 1999, holds 27 rates. Their rates are therefore typed as optional, and the full set of codes that can occur is exported as currencies and discontinuedCurrencies.

Development

Node.js and pnpm are pinned in package.json (devEngines.runtime and packageManager); pnpm downloads the pinned Node.js version itself, so no separate version manager is needed.

Install dependencies with pnpm install.

To execute the tests, run pnpm test. To lint, run pnpm run lint.

For the best development experience, make sure that your editor supports ESLint and EditorConfig.

Linting of code and commit message happens on commit via Husky.

Releasing to NPM

Commit all changes and run the following:

$ pnpm login
$ pnpm run release <update_type>
$ pnpm publish

… where <update_type> is one of patch, minor, or major. This will update the package.json, and create a tagged Git commit with the version number.

Use pnpm, not npm, for these. Because the project pins its Node version through devEngines.runtime, npm refuses to run anything here (EBADDEVENGINES) unless the ambient Node happens to match that exact version.

Contributing

Pull requests are very welcome. Feel free to discuss bugs or new features by opening a new issue.

Copyright Philipp Katz, LineUpr GmbH, 2018 – 2026