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 |