Skip to content

OpenExchangeAPI/ISO4217

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 

Repository files navigation

💱 OpenExchangeAPI Global Currency Dataset

The most complete public dataset of currencies on the internet.
Built using official sources like ISO 4217 (SIX Group), IMF, and enhanced with real-world metadata for modern applications.
Supports 275+ currencies, including fiat, crypto, commodities, virtual units, and more.


📦 What's Included?

Every currency entry includes:

  • 🔠 code — ISO 4217 or custom currency code (e.g. USD, XAU, BTC)
  • 💬 name — Full English name of the currency (e.g. Japanese Yen)
  • 🌐 localized_name — Currency name in the native language/script (e.g. , บาท)
  • 🔣 symbol — Official or commonly used symbol (e.g. $, , )
  • 🧮 minor_unit — Number of decimal subunits (e.g. 2 for cents, or null)
  • 🧾 decimal_places — How many decimals are usually shown (e.g. 2)
  • 🔢 format — Display pattern (e.g. #,##0.00 ¤)
  • 📍 decimal_separator — Symbol used for decimal (e.g. ., ,)
  • 📍 group_separator — Symbol used for digit grouping (e.g. ,, .)
  • 🗣️ language — Language used with the currency (e.g. French, Thai)
  • 🌍 locale — Locale tag (e.g. fr-FR, th-TH)
  • timezone — IANA time zone string (e.g. Europe/Berlin, Asia/Bangkok)
  • 🗺️ continent — Continent where used (e.g. Europe, Asia)
  • 🏦 governing_banks — Central bank(s) or issuer institutions
  • 👥 population — Estimated number of people using this currency
  • 🏷️ type — One of: fiat, crypto, commodity, virtual, index, non_currency

🧠 Use Cases

  • 🌐 Currency pickers with full localization
  • 📊 Financial reporting dashboards
  • 🛒 E-commerce and global pricing
  • 🔀 Currency conversion UIs
  • 🔐 Payment system integrations
  • 🌍 Global tax/invoice systems

🗂️ Files in This Repo

File Description
banks.json Governing central banks or institutions per currency
continent.json Continent associated with each currency
currencies.json Basic list of currency codes and names (ISO 4217 + extras)
currency_format_string.json Formatting patterns for displaying each currency (e.g. #,##0.00 ¤)
decimal.json Decimal separators used (e.g. ., ,)
format.json Human-readable formatting metadata
group.json Grouping/thousands separators used per currency
iso4217.json Official ISO 4217 metadata (code, numeric code, minor unit)
language.json Primary language spoken where the currency is used
locale.json IETF locale tag (e.g. en-US, fr-FR)
localized_name.json Currency names in the local/native language/script
minor_unit.json Number of subunits per major unit (e.g. 2 for cents)
population_using.json Estimated population using the currency
symbol.json Commonly used symbol for each currency
timezone.json Primary IANA time zone where currency is used
full.json 🔥 Merged superset of all fields above per currency (single flat object)

⚖️ License

MIT License.
Use it. Fork it. Ship it.
Attribution appreciated but not required.


Maintained by OpenExchangeAPI
Built with ❤️ for the global dev community.

About

🌐 The ultimate global currency dataset 💸 — based on ISO 4217 (SIX Group), IMF, and other official sources. 275+ currencies with symbols, local names, formatting, banks, population, and more. Built by OpenExchangeAPI. 🔥

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors