country-to-currency

Maps country codes (ISO 3166-1 alpha-2) to their default currency codes (ISO 4217).

⚡ Just 2.3 KB (unzipped), 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.

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

All the countries included - currently 249.
For Antarctica (AQ), the currency USD is being assumed.
For Palestine (PS), the currency ILS is being assumed.
For South Korea (KR), the currency KRW is being assumed.
For Switzerland (CH), the currenty CHF is being assumed.
For Chile (CLF), the currency CLP is being assumed.
For Uruguay (UY), the currency UYU is being assumed.

Suggestions? Please open an Issue.

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 provide new internal scripts.

xaphod/country-to-currency