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.

MIT © Thiago Delgado Pinto