current-currency 💵💶💷

Making it easy to work with currencies and cryptos!

Summary

• Getting Started
• Available functions
• Supported currencies
• Supported cryptocurrencies

Getting Started

Install current-currency with your favourite package manager.

• npm install current-currency
• yarn add current-currency

Available functions

convert

Convert is used to get the current rates of a currency.

Example

import { convert } from "current-currency";

convert("EUR", 10.2, "USD").then(res => console.log(res));
// {currency: "USD", amount: 12.35}

In the background we make use of https://exchangeratesapi.io/ to always have the current rates.

addSymbol

AddSymbol is used to add the right currency symbol in the right position using the ISO currency code.

Example

import { addSymbol } from "current-currency";

const symbolized = addSymbol("RUB", 10.2);
console.log(symbolized);
// ₽10.2

Example with force position

import { addSymbol } from "current-currency";

const symbolized = addSymbol("USD", 10.2, "post");
console.log(symbolized);
// 10.2$

extract

Extract is used to retrieve information about a currency using the ISO currency code.

Example

import { extract } from "current-currency";

const extraction = extract("10.2RUB");
console.log(extraction);
// { type: "currency", name: "Russian ruble", symbol: "₽", decimal: ",", position: "pre" }

Supported currencies

Code	Name
EUR	Euro
USD	United States Dollar
CAD	Canadian Dollar
HKD	Hong Kong Dollar
ISK	Icelandic Króna
PHP	Philippine Peso
DDK	Danish Krone
HUF	Hungarian Forint
CZK	Czech Koruna
AUD	Australian Dollar
RON	Romanian Leu
SEK	Swedish Krona
IDR	Indonesian Rupiah
INR	Indian Rupee
BRL	Brazilian Real
RUB	Russian Ruble
HRK	Croatian Kuna
JPY	Japanse Yen
TBH	Thai Baht
CHF	Swiss Franc
SGD	Singapore Dollar
PLN	Polish złoty
BGN	Bulgarian Lev
TRY	Turkish Lira
CNY	Chinese Renminbi
NOK	Norwegian Krone
NZD	New Zealand Dollar
ZAR	South African Rand
MXN	Mexican Peso
ILS	Israeli Shekel
GBP	Pound Sterling
KRW	South Korean Won
MYR	Malaysian Ringgit

Supported cryptocurrencies

Code	Name
BTC	Bitcoin
ETH	Ethereum
LTC	Litecoin
XRP	Ripple
DOGE	Dogecoin