Currency Exchange Rates library for nodejs
npm install @meio/node-currency-swap
First, you need to add a provider to swap by using addProvider() method
var swap = require('node-currency-swap');
// Add the google finance provider
swap.addProvider(new swap.providers.GoogleFinance());You can also add multiple providers
var swap = require('node-currency-swap');
// Add the google finance provider
swap.addProvider(new swap.providers.GoogleFinance());
// Add the yahoo finance provider with request timeout option in ms
swap.addProvider(new swap.providers.YahooFinance({timeout: 2000}));To get the list of all providers
// Returns the list of providers
swap.providers;To retrieve the latest exchange rate for a currency pair asynchronously.
Arguments
options- An object to specify options for quote. For complete list refer Options Section.callback(err, rate)- A callback which returns error on any failure or rate array on success.
To retrieve the latest exchange rate for a currency pair synchronously.
Arguments
options- An object to specify options for quote. For complete list refer Options Section.
// if there is single provider in the list it fetch the rate from that provider but if there are multiple provider in the list it fetch the rate from first available one.
swap.quote({currency: 'USD/SAR'}, function (err, rate) {
// print the exchange rate
console.log(rate[0].value);
// print the date from the provider
console.log(rate[0].date);
// print the provider name
console.log(rate[0].provider);
});Synchronously in case of any error it throws an error which you should handle through try/catch
// if there is single provider in the list it fetch the rate from that provider but if there are multiple provider in the list it fetch the rate from first available one.
var rate = swap.quoteSync({currency: 'USD/SAR'});
// print the exchange rate
console.log(rate[0].value);
// print the date from the provider
console.log(rate[0].date);
// print the provider name
console.log(rate[0].provider);To fetch rate from all the added providers
var rates = swap.quoteSync({currency: 'USD/SAR', fetchMultipleRate: true});
rates.forEach(function(rate){
// print the exchange rate
console.log(rate.value);
// print the date from the provider
console.log(rate.date);
// print the provider name
console.log(rate.provider);
});To fetch rate from cache if available if not it fetch the rate from provider and store in cache
var rates = swap.quoteSync({currency: 'USD/SAR', cache: true});
rates.forEach(function(rate){
// print the exchange rate
console.log(rate.value);
// print the date from the provider
console.log(rate.date);
// print the provider name
console.log(rate.provider);
});Currencies are expressed as their ISO 4217 code.
Swap provides an object of currency codes so you can use it to avoid typos.
var rates = swap.quoteSync({
currency: {
baseCurrency: swap.currencyCodes.ISO_USD,
quoteCurrency: swap.currencyCodes.ISO_AED
}
});currency- currency info to get exchange rate either as stringUSD/AEDor as object{baseCurrency:'USD', quoteCurrency:'AED'}.fetchMultipleRate- if true, fetch rate from all the added providers. (default:false)cache- if true, it tries to fetch rate from cache if available otherwise fetch rate from added provider and store it in cache. (default:false)ttl- time inmsto retain rate in cache. (default:360000) 1 hour
- European Central Bank Supports only EUR as base currency.
// options.timeout in ms (optional) To set request timeout default (default: 3000ms)
swap.addProvider(new swap.providers.EuropeanCentralBank(options));- Google Finance Supports multiple currencies as base and quote currencies.
// options.timeout in ms (optional) To set request timeout (default: 3000ms)
swap.addProvider(new swap.providers.GoogleFinance(options));- Open Exchange Rates Supports only USD as base currency for the free version and multiple ones for the enterprise version.
// options.appId (required) API key from open exchange rates
// options.enterprise (optional) true in case you have enterprise account (default: false)
// options.timeout in ms (optional) To set request timeout (default: 3000ms)
swap.addProvider(new swap.providers.OpenExchangeRates(options));- Xignite
You must have access to the
XigniteGlobalCurrenciesAPI. Supports multiple currencies as base and quote currencies.
// options.token (required) API token from Xignite
// options.timeout in ms (optional) To set request timeout (default: 3000ms)
swap.addProvider(new swap.providers.Xignite(options));- Yahoo Finance Supports multiple currencies as base and quote currencies.
// options.timeout in ms (optional) To set request timeout (default: 3000ms)
swap.addProvider(new swap.providers.YahooFinance(options));- National Bank of Romania Supports only RON as base currency.
// options.timeout in ms (optional) To set request timeout (default: 3000ms)
swap.addProvider(new swap.providers.NationalBankOfRomania(options));- Currency Layer Supports multiple currencies as base and quote currencies.
// options.accessKey (required) API access key from Currency Layer.
// options.timeout in ms (optional) To set request timeout (default: 3000ms)
swap.addProvider(new swap.providers.CurrencyLayer(options));node-currency-swap is designed to be a simple and universal exchange rate library with support for multiple providers. This library is heavily inspired from PHP Swap
The code is available under the MIT license.