currency-country

Get currency codes and symbols for countries, and find which countries use a specific currency.

• ISO 3166-1 alpha-2 country codes (247 countries)
• ISO 4217 currency codes (153 currencies)
• Currency symbols included
• Works with ESM and CommonJS

Data current as of January 2026. Most recent update: Bulgaria's adoption of the Euro.

Installation

npm install currency-country

Usage

ES Modules (recommended)

import {
  getCurrencyCode,
  getCurrencySymbol,
  getCurrencyForCountry,
  getCountriesForCurrency,
} from "currency-country";

getCurrencyCode("US"); // "USD"
getCurrencySymbol("USD"); // "$"

CommonJS

const {
  getCurrencyCode,
  getCurrencySymbol,
  getCurrencyForCountry,
  getCountriesForCurrency,
} = require("currency-country");

getCurrencyCode("US"); // "USD"
getCurrencySymbol("USD"); // "$"

TypeScript

Full type definitions are included:

import {
  getCurrencyCode,
  getCurrencyForCountry,
  type CurrencyInfo,
  type CountryCode,
  type CurrencyCode,
} from "currency-country";

const currency: CurrencyInfo | undefined = getCurrencyForCountry("US");
// { code: "USD", symbol: "$" }

Examples

// Get currency code for a country
getCurrencyCode("US"); // "USD"
getCurrencyCode("JP"); // "JPY"
getCurrencyCode("DE"); // "EUR"

// Get currency symbol
getCurrencySymbol("USD"); // "$"
getCurrencySymbol("EUR"); // "€"
getCurrencySymbol("GBP"); // "£"
getCurrencySymbol("INR"); // "₹"

// Get full currency info for a country
getCurrencyForCountry("US");
// { code: "USD", symbol: "$" }

getCurrencyForCountry("IN");
// { code: "INR", symbol: "₹" }

// Get all countries using a currency
getCountriesForCurrency("EUR");
// ["AX", "AD", "AT", "BE", "BG", "HR", "CY", "EE", "FI", "FR", ...]

getCountriesForCurrency("USD");
// ["AS", "BQ", "IO", "EC", "SV", "GU", "MH", "FM", "MP", "PW", "PR", "TL", "TC", "UM", "US", "VG", "VI"]

API

getCurrencyCode(countryCode: string): string | undefined

Get the ISO 4217 currency code for a country.

getCurrencySymbol(currencyCode: string): string | undefined

Get the symbol for a currency code.

getCurrencyForCountry(countryCode: string): CurrencyInfo | undefined

Get full currency info (code and symbol) for a country.

interface CurrencyInfo {
  code: string;
  symbol: string | undefined;
}

getCountriesForCurrency(currencyCode: string): string[]

Get all country codes that use a specific currency.

getCountryInfo(countryCode: string): CountryInfo | undefined

Get full country info including currency.

interface CountryInfo {
  code: string;
  currency: CurrencyInfo;
}

isValidCountryCode(countryCode: string): boolean

Check if a country code exists in the dataset.

isValidCurrencyCode(currencyCode: string): boolean

Check if a currency code exists in the dataset.

getAllCountryCodes(): string[]

Get all supported country codes.

getAllCurrencyCodes(): string[]

Get all supported currency codes.

Raw Data

For advanced use cases, you can import the raw data:

import {
  countryToCurrency, // Record<string, string> - country -> currency
  currencySymbols, // Record<string, string> - currency -> symbol
  currencyToCountries, // Record<string, string[]> - currency -> countries
} from "currency-country";

License

MIT