Currenzy - Exchange Rates

Free module to get the conversion rates for dozens of currencies. Conversion rates are updated via GitHub Actions every 12 hours.

Note: The module fetches the latest rates from a URL, not the local file (i.e. there is no need to update the package to get the newest rates).

Installation

npm install currenzy

Usage

Initialize Currenzy with the base currency. If not provided, the base currency by default is EUR. Currency uses the ISO 4217 standard.

import Currenzy from 'currenzy';

const currenzy = new Currenzy('EUR');

Methods

Conversion

To make a conversion, add the amount and the target currency:

const amountInUSD = await currenzy.convert(5, 'USD');
// 5.266205

Refresh rates

The class instance downloads the latest rates from this repo, but saves the results in memory.

The convert() method automatically checks if the data is older than 6 hours. If so, it fetches again the data.

However, you can re-fetch the latest rates using the refreshRates method:

await currenzy.refreshRates();

Currencies

This is the list of supported currencies by Currenzy:

| | | | | | | | | | |-----|-----|-----|-----|-----|-----|-----|-----|-----| | AED | BRL | CZK | GYD | KHR | MMK | PGK | SOS | UZS | | AFN | BSD | DJF | HKD | KMF | MNT | PHP | SRD | VEF | | ALL | BTC | DKK | HNL | KPW | MOP | PKR | STD | VES | | AMD | BTN | DOP | HRK | KRW | MRO | PLN | SVC | VND | | ANG | BWP | DZD | HTG | KWD | MUR | PYG | SYP | VUV | | AOA | BYN | EGP | HUF | KYD | MVR | QAR | SZL | WST | | ARS | BYR | ERN | IDR | KZT | MWK | RON | THB | XAF | | AUD | BZD | ETB | ILS | LAK | MXN | RSD | TJS | XAG | | AWG | CAD | EUR | IMP | LBP | MYR | RUB | TMT | XAU | | AZN | CDF | FJD | INR | LKR | MZN | RWF | TND | XCD | | BAM | CHF | FKP | IQD | LRD | NAD | SAR | TOP | XDR | | BBD | CLF | GBP | IRR | LSL | NGN | SBD | TRY | XOF | | BDT | CLP | GEL | ISK | LTL | NIO | SCR | TTD | XPF | | BGN | CNY | GGP | JEP | LVL | NOK | SDG | TWD | YER | | BHD | COP | GHS | JMD | LYD | NPR | SEK | TZS | ZAR | | BIF | CRC | GIP | JOD | MAD | NZD | SGD | UAH | ZMK | | BMD | CUC | GMD | JPY | MDL | OMR | SHP | UGX | ZMW | | BND | CUP | GNF | KES | MGA | PAB | SLE | USD | ZWL | | BOB | CVE | GTQ | KGS | MKD | PEN | SLL | UYU | |

CLI support

You can also use Currenzy from your terminal!

Install the package globally:

npm install currenzy@latest -g

Use as follows:

cur <fromAmount> <fromCurrency> <targetCurrency>

Example:

cur 1 eur usd

Would output: 1.081233 USD

Template

Used the package template from get-template

npx get-template@latest package