💱 Free, open-source library for fetching, managing, and converting up-to-date currency rates from multiple reliable sources, with the ability to easily choose your provider.

📚 For more detailed documentation and advanced usage, visit Currzy Docs.

Features

• Get current exchange rates for supported currencies.
• Convert amounts between different currencies.
• Cache rates locally to reduce API calls (cache expires after 1 hour).
• Clear the cache manually when needed.
• Easily switch between providers (e.g., CBRF).

Installation

npm i currzy

Usage

import { Currzy } from "currzy";

async function main() {
  // Initialize with a provider
  const currzy = new Currzy("cbrf");

  // Get the rate of EUR to USD
  const rate = await currzy.getRate("EUR", "USD");
  console.log(`1 USD = ${rate.toFixed(4)} EUR`);

  // Convert 100 USD to EUR
  const converted = await currzy.convert(100, "USD", "EUR");
  console.log(`100 USD = ${converted.toFixed(2)} EUR`);

  // Get all rates relative to USD
  const allRates = await currzy.getAllRatesTo("USD");
  console.log(allRates);

  // Get last update date
  console.log("Last update:", currzy.getLastUpdate());

  // Clear cache manually
  await currzy.clearCache();
  console.log("Cache cleared.");
}

main();

Notes

• Each provider may have its own methods
• Rates are cached locally for 1 hour to minimize API requests.
• Cache can be cleared manually via currzy.clearCache()

Supported Currencies (CbrfProvider)

| AUD | AZN | DZD | GBP | AMD | BHD | BYN | BGN | BOB | BRL | |-----|-----|-----|-----|-----|-----|-----|-----|-----|-----| | HUF | VND | HKD | GEL | DKK | AED | USD | EUR | EGP | INR | | IDR | IRR | KZT | CAD | QAR | KGS | CNY | CUP | MDL | MNT | | NGN | NZD | NOK | OMR | PLN | SAR | RON | XDR | SGD | TJS | | THB | BDT | TRY | TMT | UZS | UAH | CZK | SEK | CHF | ETB | | RSD | ZAR | KRW | JPY | MMK | RUB | | | | |