Skip to content

Improve metadata: add descriptions, fix NumericCode type, fix sources path #23

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
olayway merged 2 commits into from
May 15, 2026
Merged

Improve metadata: add descriptions, fix NumericCode type, fix sources path #23

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
65ff859
Improve metadata: add descriptions, fix NumericCode type, fix sources…
olayway May 15, 2026
89ca457
Apply optional metadata improvements
olayway May 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 7 additions & 12 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
<a className="gh-badge" href="https://datahub.io/core/currency-codes"><img src="https://badgen.net/badge/icon/View%20on%20datahub.io/orange?icon=https://datahub.io/datahub-cube-badge-icon.svg&label&scale=1.25" alt="badge" /></a>

<a className="gh-badge" href="https://datahub.io/core/currency-codes"><img src="https://badgen.net/badge/icon/View%20on%20datahub.io/orange?icon=https://datahub.io/datahub-cube-badge-icon.svg&label&scale=1.25" alt="badge" /></a>
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 denominations".

Note that the [ISO page][iso-4217] offers pay-for PDFs but also links to [http://www.currency-iso.org/en/home/tables.html](http://www.currency-iso.org/en/home/tables.html) which does provide them in machine readable form freely.
Note that the [ISO page][iso-4217] offers pay-for PDFs but also links to [SIX Group's data standards page][iso-4217] which provides them in machine readable form freely.

[iso-4217]: https://www.six-group.com/en/products-services/financial-information/data-standards.html
[iso-4217]: https://www.six-group.com/en/products-services/financial-information/market-reference-data/data-standards.html

## Data

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

Expand All @@ -22,9 +22,9 @@ separate tables:

## Preparation

The script requires recode package to be istalled. Install it by running:
The script requires `xmllint` (from the `libxml2-utils` package). Install it by running:

`sudo apt install recode`
`sudo apt install libxml2-utils`

Run the following script to download and convert the data from XML to
CSV:
Expand All @@ -37,11 +37,6 @@ cd scripts/
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.
Expand Down
17 changes: 10 additions & 7 deletions datapackage.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
{
"name": "currency-codes",
"title": "ISO 4217 Currency Codes",
"description": "ISO 4217 currency codes: current currencies (Table A.1) and historic denominations (Table A.3), sourced from SIX Interbank Clearing Ltd on behalf of ISO.",
"licenses": [
{
"name": "ODC-PDDL-1.0",
"path": "http://opendatacommons.org/licenses/pddl/",
"path": "https://opendatacommons.org/licenses/pddl/",
"title": "Open Data Commons Public Domain Dedication and License v1.0"
}
],
Expand All @@ -18,8 +19,9 @@
"sources": [
{
"name": "SIX Interbank Clearing Ltd (on behalf of ISO)",
"email": "office@currency-iso.org",
"title": "SIX Interbank Clearing Ltd (on behalf of ISO)"
"title": "SIX Interbank Clearing Ltd (on behalf of ISO)",
"path": "https://www.six-group.com/en/products-services/financial-information/data-standards.html",
"email": "office@currency-iso.org"
}
],
"contributors": [
Expand All @@ -37,6 +39,7 @@
{
"path": "data/codes-all.csv",
"name": "codes-all",
"description": "Consolidated list of ISO 4217 current and historic currency codes, one row per country–currency pair.",
"mimetype": "text/csv",
"size": "16863",
"schema": {
Expand All @@ -60,20 +63,20 @@
{
"name": "NumericCode",
"title": "Numeric Code",
"type": "number",
"description": "3 digit numeric code"
"type": "string",
"description": "3 digit numeric code (zero-padded, e.g. '008')"
},
{
"name": "MinorUnit",
"title": "Minor Unit",
"type": "string",
"description": ""
"description": "Number of digits after the decimal separator; '-' for currencies with no minor unit defined"
},
{
"name": "WithdrawalDate",
"title": "Withdrawal Date",
"type": "string",
"description": "Date currency withdrawn (values can be ranges or months"
"description": "Date the currency was withdrawn; values may be a year-month (YYYY-MM) or a date range (e.g. '1990-07 to 1990-09'); empty for current currencies"
}
]
}
Expand Down