Published

ISO 4217 Currency Codes

7.2K
51.9K

List of currencies and their 3 digit codes as defined by [ISO 4217][iso-4217]. The data provided here is the consolidation of Table A.1 "Current currency & funds code list" and Table A.3 "Historic d...

API Access

Access dataset files directly from scripts, code, or AI agents.

Browse dataset files
Dataset Files

Each file has a stable URL (r-link) that you can use directly in scripts, apps, or AI agents. These URLs are permanent and safe to hardcode.

/core/currency-codes/
https://datahub.io/core/currency-codes/_r/-/.gitignore
https://datahub.io/core/currency-codes/_r/-/README.md
https://datahub.io/core/currency-codes/_r/-/archive/table_a1.xml
https://datahub.io/core/currency-codes/_r/-/archive/table_a2.xml
https://datahub.io/core/currency-codes/_r/-/data/codes-all.csv
https://datahub.io/core/currency-codes/_r/-/datapackage.json
Key Files

Start with these files — they give you everything you need to understand and access the dataset.

datapackage.jsonmetadata & schema
https://datahub.io/core/currency-codes/_r/-/datapackage.json
README.mddocumentation
https://datahub.io/core/currency-codes/_r/-/README.md
Typical Usage
  1. 1. Fetch datapackage.json to inspect schema and resources
  2. 2. Download data resources listed in datapackage.json
  3. 3. Read README.md for full context

Data Previews

codes-all

Loading data...

Schema

nametypedescriptiontitle
EntitystringCountry or region name
CurrencystringName of the currency
AlphabeticCodestring3 digit alphabetic code for the currencyAlphabetic Code
NumericCodenumber3 digit numeric codeNumeric Code
MinorUnitstringMinor Unit
WithdrawalDatestringDate currency withdrawn (values can be ranges or monthsWithdrawal Date

Data Files

FileDescriptionSizeLast modifiedDownload
codes-all
17.9 kB26 days ago
codes-all
FilesSizeFormatCreatedUpdatedLicenseSource
117.9 kBabout 1 month agoOpen Data Commons Public Domain Dedication and License v1.0SIX Interbank Clearing Ltd (on behalf of ISO)

badge

List of currencies and their 3 digit codes as defined by ISO 4217. The data provided here is the consolidation of Table A.1 "Current currency & funds code list" and Table A.3 "Historic denominations".

Note that the ISO page offers pay-for PDFs but also links to http://www.currency-iso.org/en/home/tables.html which does provide them in machine readable form freely.

Data

The data provided (see data/codes.csv) in this data package provides a consolidated list of currency (and funds) codes by combining these two separate tables:

Preparation

The script requires recode package to be istalled. Install it by running:

sudo apt install recode

Run the following script to download and convert the data from XML to CSV:

cd scripts/
./runall.sh

The raw XML files are stored in ./archive. The cleaned data are ./data/codes-all.csv.

Version

The current tables have a published date of 28 March 2014 (as indicated in the XML files).

License

Placing in the Public Domain under the Public Domain Dedication and License. The original site states no restriction on use and the data is small and completely factual.