JSONKit
Data

Currency Codes (ISO 4217) JSON Example

A structured JSON reference of ISO 4217 currency codes with numeric codes, minor units (decimal places), symbols, and sample countries. Essential for payment forms, financial APIs, and e-commerce localization.

{
  "currencies": [
    {
      "code": "USD",
      "numericCode": "840",
      "minorUnits": 2,
      "name": "United States Dollar",
      "symbol": "$",
      "sampleCountries": [
        "United States",
        "Ecuador",
        "El Salvador"
      ]
    },
    {
      "code": "EUR",
      "numericCode": "978",
      "minorUnits": 2,
      "name": "Euro",
      "symbol": "€",
      "sampleCountries": [
        "Germany",
        "France",
        "Italy"
      ]
    },
    {
      "code": "GBP",
      "numericCode": "826",
      "minorUnits": 2,
      "name": "British Pound Sterling",
      "symbol": "£",
      "sampleCountries": [
        "United Kingdom"
      ]
    },
    {
      "code": "JPY",
      "numericCode": "392",
      "minorUnits": 0,
      "name": "Japanese Yen",
      "symbol": "¥",
      "sampleCountries": [
        "Japan"
      ]
    },
    {
      "code": "CNY",
      "numericCode": "156",
      "minorUnits": 2,
      "name": "Chinese Yuan Renminbi",
      "symbol": "¥",
      "sampleCountries": [
        "China"
      ]
    },
    {
      "code": "INR",
      "numericCode": "356",
      "minorUnits": 2,
      "name": "Indian Rupee",
      "symbol": "₹",
      "sampleCountries": [
        "India"
      ]
    },
    {
      "code": "CAD",
      "numericCode": "124",
      "minorUnits": 2,
      "name": "Canadian Dollar",
      "symbol": "CA$",
      "sampleCountries": [
        "Canada"
      ]
    },
    {
      "code": "AUD",
      "numericCode": "036",
      "minorUnits": 2,
      "name": "Australian Dollar",
      "symbol": "A$",
      "sampleCountries": [
        "Australia"
      ]
    },
    {
      "code": "CHF",
      "numericCode": "756",
      "minorUnits": 2,
      "name": "Swiss Franc",
      "symbol": "Fr",
      "sampleCountries": [
        "Switzerland",
        "Liechtenstein"
      ]
    },
    {
      "code": "HKD",
      "numericCode": "344",
      "minorUnits": 2,
      "name": "Hong Kong Dollar",
      "symbol": "HK$",
      "sampleCountries": [
        "Hong Kong"
      ]
    },
    {
      "code": "SGD",
      "numericCode": "702",
      "minorUnits": 2,
      "name": "Singapore Dollar",
      "symbol": "S$",
      "sampleCountries": [
        "Singapore"
      ]
    },
    {
      "code": "KRW",
      "numericCode": "410",
      "minorUnits": 0,
      "name": "South Korean Won",
      "symbol": "₩",
      "sampleCountries": [
        "South Korea"
      ]
    },
    {
      "code": "BRL",
      "numericCode": "986",
      "minorUnits": 2,
      "name": "Brazilian Real",
      "symbol": "R$",
      "sampleCountries": [
        "Brazil"
      ]
    },
    {
      "code": "MXN",
      "numericCode": "484",
      "minorUnits": 2,
      "name": "Mexican Peso",
      "symbol": "MX$",
      "sampleCountries": [
        "Mexico"
      ]
    },
    {
      "code": "RUB",
      "numericCode": "643",
      "minorUnits": 2,
      "name": "Russian Ruble",
      "symbol": "₽",
      "sampleCountries": [
        "Russia"
      ]
    },
    {
      "code": "SEK",
      "numericCode": "752",
      "minorUnits": 2,
      "name": "Swedish Krona",
      "symbol": "kr",
      "sampleCountries": [
        "Sweden"
      ]
    },
    {
      "code": "NOK",
      "numericCode": "578",
      "minorUnits": 2,
      "name": "Norwegian Krone",
      "symbol": "kr",
      "sampleCountries": [
        "Norway"
      ]
    },
    {
      "code": "DKK",
      "numericCode": "208",
      "minorUnits": 2,
      "name": "Danish Krone",
      "symbol": "kr",
      "sampleCountries": [
        "Denmark"
      ]
    },
    {
      "code": "AED",
      "numericCode": "784",
      "minorUnits": 2,
      "name": "UAE Dirham",
      "symbol": "د.إ",
      "sampleCountries": [
        "United Arab Emirates"
      ]
    },
    {
      "code": "SAR",
      "numericCode": "682",
      "minorUnits": 2,
      "name": "Saudi Riyal",
      "symbol": "﷼",
      "sampleCountries": [
        "Saudi Arabia"
      ]
    },
    {
      "code": "TRY",
      "numericCode": "949",
      "minorUnits": 2,
      "name": "Turkish Lira",
      "symbol": "₺",
      "sampleCountries": [
        "Turkey"
      ]
    },
    {
      "code": "ZAR",
      "numericCode": "710",
      "minorUnits": 2,
      "name": "South African Rand",
      "symbol": "R",
      "sampleCountries": [
        "South Africa"
      ]
    },
    {
      "code": "THB",
      "numericCode": "764",
      "minorUnits": 2,
      "name": "Thai Baht",
      "symbol": "฿",
      "sampleCountries": [
        "Thailand"
      ]
    },
    {
      "code": "IDR",
      "numericCode": "360",
      "minorUnits": 2,
      "name": "Indonesian Rupiah",
      "symbol": "Rp",
      "sampleCountries": [
        "Indonesia"
      ]
    },
    {
      "code": "MYR",
      "numericCode": "458",
      "minorUnits": 2,
      "name": "Malaysian Ringgit",
      "symbol": "RM",
      "sampleCountries": [
        "Malaysia"
      ]
    }
  ]
}

Field Reference

coderequiredstringThree-letter ISO 4217 currency code (e.g. 'USD', 'EUR')
numericCoderequiredstringThree-digit zero-padded ISO 4217 numeric code (e.g. '840')
minorUnitsrequirednumberNumber of decimal places used by the currency (0 for JPY, 2 for USD, 3 for KWD)
namerequiredstringFull official currency name
symbolrequiredstringCommon typographic symbol for the currency (e.g. '$', '€', '£')
sampleCountriesrequiredstring[]One to three countries that officially use this currency

Variants

Major Reserve CurrenciesThe six currencies held in the largest volumes by central banks worldwide.
Major Reserve Currencies
{
  "currencies": [
    {
      "code": "USD",
      "numericCode": "840",
      "minorUnits": 2,
      "name": "United States Dollar",
      "symbol": "$",
      "sampleCountries": [
        "United States"
      ]
    },
    {
      "code": "EUR",
      "numericCode": "978",
      "minorUnits": 2,
      "name": "Euro",
      "symbol": "€",
      "sampleCountries": [
        "Germany",
        "France"
      ]
    },
    {
      "code": "GBP",
      "numericCode": "826",
      "minorUnits": 2,
      "name": "British Pound Sterling",
      "symbol": "£",
      "sampleCountries": [
        "United Kingdom"
      ]
    },
    {
      "code": "JPY",
      "numericCode": "392",
      "minorUnits": 0,
      "name": "Japanese Yen",
      "symbol": "¥",
      "sampleCountries": [
        "Japan"
      ]
    },
    {
      "code": "CHF",
      "numericCode": "756",
      "minorUnits": 2,
      "name": "Swiss Franc",
      "symbol": "Fr",
      "sampleCountries": [
        "Switzerland"
      ]
    },
    {
      "code": "CNY",
      "numericCode": "156",
      "minorUnits": 2,
      "name": "Chinese Yuan Renminbi",
      "symbol": "¥",
      "sampleCountries": [
        "China"
      ]
    }
  ]
}
Asian CurrenciesCurrencies used across major Asian economies.
{
  "currencies": [
    {
      "code": "JPY",
      "numericCode": "392",
      "minorUnits": 0,
      "name": "Japanese Yen",
      "symbol": "¥",
      "sampleCountries": [
        "Japan"
      ]
    },
    {
      "code": "CNY",
      "numericCode": "156",
      "minorUnits": 2,
      "name": "Chinese Yuan Renminbi",
      "symbol": "¥",
      "sampleCountries": [
        "China"
      ]
    },
    {
      "code": "INR",
      "numericCode": "356",
      "minorUnits": 2,
      "name": "Indian Rupee",
      "symbol": "₹",
      "sampleCountries": [
        "India"
      ]
    },
    {
      "code": "KRW",
      "numericCode": "410",
      "minorUnits": 0,
      "name": "South Korean Won",
      "symbol": "₩",
      "sampleCountries": [
        "South Korea"
      ]
    },
    {
      "code": "HKD",
      "numericCode": "344",
      "minorUnits": 2,
      "name": "Hong Kong Dollar",
      "symbol": "HK$",
      "sampleCountries": [
        "Hong Kong"
      ]
    },
    {
      "code": "SGD",
      "numericCode": "702",
      "minorUnits": 2,
      "name": "Singapore Dollar",
      "symbol": "S$",
      "sampleCountries": [
        "Singapore"
      ]
    },
    {
      "code": "THB",
      "numericCode": "764",
      "minorUnits": 2,
      "name": "Thai Baht",
      "symbol": "฿",
      "sampleCountries": [
        "Thailand"
      ]
    },
    {
      "code": "IDR",
      "numericCode": "360",
      "minorUnits": 2,
      "name": "Indonesian Rupiah",
      "symbol": "Rp",
      "sampleCountries": [
        "Indonesia"
      ]
    },
    {
      "code": "MYR",
      "numericCode": "458",
      "minorUnits": 2,
      "name": "Malaysian Ringgit",
      "symbol": "RM",
      "sampleCountries": [
        "Malaysia"
      ]
    }
  ]
}

Common Use Cases

  • →Payment forms — display the correct symbol and enforce the right number of decimal places
  • →Currency conversion APIs — map codes to numeric codes when calling banking APIs
  • →Financial reporting — normalize amounts to minor units (cents) before storing
  • →E-commerce localization — show prices in the shopper's local currency
  • →Forex dashboards — use ISO codes as keys for exchange rate lookup tables
ISO 4217currency codesfinancepaymentsforexexchange rate

Validate or format this JSON

One click loads this exact example into the tool — no copy-paste needed. Format it, validate it, explore the tree, or generate TypeScript types instantly.

FormatValidateExplore treeGenerate TypeScriptMinify

Frequently Asked Questions

ISO 4217 is the international standard that defines three-letter codes for currencies (e.g. USD, EUR) and three-digit numeric codes used when letters are impractical. It is maintained by the ISO and is universally adopted by banks, payment processors, and financial software.

Minor units describe the relationship between the currency and its smallest denomination. A minorUnits of 2 means the currency uses 100 sub-units (e.g. 1 USD = 100 cents). When storing monetary values as integers to avoid floating-point errors, multiply the decimal amount by 10^minorUnits (e.g. $9.99 → 999 cents).

The Japanese Yen has no subdivisions in everyday use — there are no 'yen cents'. ISO 4217 assigns minorUnits: 0, meaning amounts are always whole numbers. Passing 100 to a payment API expecting minor units for JPY means ¥100, not ¥1.00 as it would for USD.

ISO 4217 also defines codes for precious metals (XAU = gold, XAG = silver) and special purpose codes (XDR = IMF Special Drawing Rights). These start with 'X' by convention and have no physical banknotes. They are used in commodities trading, central bank reserves reporting, and international settlement.

Related JSON Examples

DataCountry Codes (ISO 3166-1)ISO 3166-1 country codes with alpha-2, alpha-3, numeric, continent, and calling code.DataIANA Timezones ReferenceMajor IANA timezone IDs with UTC offsets, DST offsets, and regional metadata.