A complete mapping of every country to its official currency, including the ISO 4217 three-letter code, full currency name, and standard symbol. Whether you are building e-commerce checkout flows, localizing price displays, or generating multi-currency invoices, this dataset gives you the reference data you need.
Pro tip: Some currency symbols are shared across countries — "$" is used by USD, CAD, AUD, and others. Always pair the symbol with the ISO code to avoid ambiguity in international applications.
Select which columns to include in your download.
About the Country Currency Dataset
This dataset maps each of the 249 recognized countries and territories to their official currency as defined by ISO 4217. The ISO 4217 standard is maintained by the International Organization for Standardization and provides unique three-letter codes for every currency in active use. These codes are the global standard used by banks, payment processors, accounting software, and international trade systems. Each entry includes the country name, the three-letter currency code, the full currency name, and the display symbol.
Common Use Cases
- E-commerce localization: Detect a visitor's country and automatically display prices in their local currency with the correct symbol and formatting.
- Payment processing: Map transaction currencies to their ISO codes when integrating with Stripe, PayPal, Square, or other payment gateways that require standardized currency identifiers.
- Invoice generation: Automatically set the currency code and symbol on invoices based on the client's country for multi-national billing systems.
- Financial reporting: Join currency data with transaction records to group revenue by currency for consolidated financial statements and foreign exchange analysis.
Column Reference
- country — The common English name of the country or territory.
- currency_code — The ISO 4217 three-letter currency code (e.g. "USD", "EUR", "GBP").
- currency_name — The full name of the currency (e.g. "United States Dollar", "Euro").
- symbol — The standard currency symbol used for display (e.g. "$", "€", "£").
Understanding Currency Sharing
Many countries share the same currency. The Euro (EUR) is used by 20 Eurozone countries. The US Dollar (USD) is the official currency of several countries and territories beyond the United States. The CFA Franc is shared across multiple West and Central African nations. This dataset includes every country-to-currency relationship individually, so each country has its own row even when the currency is shared. This approach makes it easy to look up any country without needing to resolve currency union membership.
How to Import Into Your Application
Download the JSON format to use as a runtime lookup dictionary keyed by country name or ISO code. For database-driven applications, import the CSV into a reference table and JOIN it against your customer or order tables to resolve currency information. The dataset works well as a seed file for currency selector components in React, Vue, or Angular applications — load the JSON at build time or on page load to populate currency dropdown menus.