README.md

💱 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.