country-to-currency
Maps country codes (ISO 3166-1 alpha-2) to their default currency codes (ISO 4217).
⚡ Just 2.3 KB (uncompressed), no external dependencies.
🎯 Work with browsers, NodeJS, and DenoJS. JavaScript and TypeScript.
Install
npm i country-to-currency
Usage
This library exports a default object that maps country codes to currency codes.
Available formats include UMD (therefore AMD and CommonJS) and ESM.
TypeScript
From version 1.1.0
on, there are two union types available (TypeScript 3.4+ only):
-
Currencies
, that contains all the currencies; -
Countries
, that contains all the countries.
Example (TypeScript on NodeJS):
import countryToCurrency, { Currencies, Countries } from "country-to-currency";
Browser - without installing anything
Global:
<script crossorigin src="https://unpkg.com/country-to-currency" ></script>
<script>
console.log( countryToCurrency ); // {AF: "AFN", AX: "EUR", ... }
console.log( countryToCurrency[ 'US' ] ); // USD
console.log( countryToCurrency[ 'DE' ] ); // EUR
console.log( countryToCurrency[ 'BR' ] ); // BRL
</script>
ESM:
<script type="module" >
import countryToCurrency from "https://unpkg.com/country-to-currency/index.esm.js";
console.log( countryToCurrency[ 'US' ] ); // USD
</script>
NodeJS
const countryToCurrency = require( 'country-to-currency' );
console.log( countryToCurrency[ 'US' ] ); // USD
DenoJS
import countryToCurrency from "https://unpkg.com/country-to-currency/index.esm.js";
console.log( countryToCurrency[ 'US' ] ); // USD
Notes
- Countries included:
250
. - For
Antarctica
(AQ
), the currencyUSD
is being assumed. - For
Chile
(CLF
), the currencyCLP
is being assumed. - For
Croatia
(HR
), the currencyEUR
is being assumed since January 1st, 2023. - For
Cuba
(CU
), the currencyCUP
is being assumed since 2021. - For
Dominican Republic
(DM
), the currencyXCD
is being assumed. - For
El Salvador
(SV
), the currencyUSD
is being assumed. - For
Hungary
(HU
), the currencyHUF
is being assumed. - For
Niger
(NE
), the currencyXOF
is being assumed. - For
Palestine
(PS
), the currencyILS
is being assumed. - For
Republic of the Congo
(CG
), the currencyXAF
is being assumed. - For
Samoa
(WS
), the currencyWST
is being assumed. - For
Sierra Leone
(SL
), the currencySLE
is being assumed since since January 1st, 2024. - For
South Georgia and the South Sandwich Islands
(GS
), the currencyFKP
is being assumed. - For
South Korea
(KR
), the currencyKRW
is being assumed. - For
Switzerland
(CH
), the currencyCHF
is being assumed. - For
Uruguay
(UY
), the currencyUYU
is being assumed.
Suggestions? Please open an Issue. Pull Requests? Make sure to edit generate.js instead of index.ts.
License
This library is inspired by Michael Rhodes' currency-code-map. The current project adds new currencies, offers support to browsers and DenoJS, updates dependencies, and provides new internal scripts.