Map country codes (ISO 3166-1 alpha-2) to their default currency codes (ISO 4217)
npm install country-to-currency
shell
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.
👉 Examples available in the folder examples.
$3
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 using TypeScript on NodeJS:
`typescript
import countryToCurrency, { Currencies, Countries } from "country-to-currency";
`
$3
Global:
`html
`
ESM:
`html
`
$3
`js
const countryToCurrency = require( 'country-to-currency/index.cjs' ); // '/index.cjs' needed since version 2.0
console.log( countryToCurrency[ 'US' ] ); // USD
`
$3
`js
import countryToCurrency from "https://unpkg.com/country-to-currency/index.esm.js";
console.log( countryToCurrency[ 'US' ] ); // USD
`
Notes
- Countries included: 251
- Imported: 249
- Included: 2
- Fixed: 17
- Currencies assumed:
| Country | Currency | Details | Thanks to |
|---------|----------|---------|-----------|
| Antarctica (AQ) | USD | Antarctica has no official currency | @thiagodp|
| Palestine (PS) | ILS | Google | @thiagodp|
| Turkey (TR) | TRY | Wikipedia | @kylem123, @thiagodp|
| South Korea (KR) | KRW | ISO 4217 | @MunjaeLee, @thiagodp|
| Switzerland (CH) | CHF | Wikipedia | @betabong, @thiagodp|
| Chile (CL) | CLP | CLF is a non-circulating currency. Wikipedia | @thiagodp|
| Uruguay (UY) | UYU | Wikipedia | @marneborn, @thiagodp|
| Croatia (HR) | EUR | Since January 1st, 2023. Wikipedia and Stripe | @xaphod, @thiagodp|
| Netherlands Antilles (AN) | ANG | ISO 4217 | @jayPare, @thiagodp|
| El Salvador (SV) | USD | Since 2001. Wikipedia | @chaitanya-d, @thiagodp|
| South Georgia and the South Sandwich Islands (GS) | FKP | Wikipedia and https://gov.gs | @danielrentz, @thiagodp|
| Cuba (CU) | CUP | Wikipedia | @jasongitmail, @thiagodp|
| Hungary (HU) | HUF | Wikipedia | @jasongitmail, @thiagodp|
| Samoa (WS) | WST | Wikipedia | @jasongitmail, @thiagodp|
| Niger (NE) | XOF | Wikipedia | @danielrentz, @thiagodp|
| Republic of the Congo (CG) | XAF | Wikipedia | @jasongitmail, @thiagodp|
| Dominican Republic (DM) | XCD | Wikipedia | @jasongitmail, @thiagodp|
| Sierra Leone (SL) | SLE | Wikipedia and European Union | @jasongitmail, @thiagodp|
| Kosovo (XK) | EUR` | Wikipedia and Geo Names | @dukesilverr, @thiagodp|