Package Exports

currency-codes
currency-codes/data
currency-codes/data.js
currency-codes/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (currency-codes) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

currency-codes

A node.js module to list and work on currency codes based on the ISO 4217 standard.

npm install currency-codes

code('EUR')

var cc = require('currency-codes');
console.log(cc.code('EUR'));

/*
{
    code: 'EUR',
    number: 978,
    digits: 2,
    currency: 'Euro',
    countries: [
        'andorra', 'austria', 'belgium', 'cyprus', 'estonia', 'finland',
        'france', 'germany', 'greece', 'ireland', 'italy', 'kosovo',
        'luxembourg', 'malta', 'monaco', 'montenegro', 'netherlands',
        'portugal', 'san marino', 'slovakia', 'slovenia', 'spain',
        'vatican city' ]
}
*/

number(967)

var cc = require('currency-codes');
console.log(cc.number(967));

/*
{
    code: 'ZMW',
    number: 967,
    digits: 2,
    currency: 'Zambian kwacha',
    countries: [ 'zambia' ] }
*/

country('colombia')

var cc = require('currency-codes');
console.log(cc.country('colombia'));

/*
[
    {
        code: 'COP',
        number: 170,
        digits: 2,
        currency: 'Colombian peso',
        countries: [ 'colombia' ]
    }, {
        code: 'COU',
        number: 970,
        digits: 2,
        currency: 'Unidad de Valor Real',
        countries: [ 'colombia' ]
    }
]
*/

codes()

var cc = require('currency-codes');
console.log(cc.codes());

/*
[
    'AED',
    'AFN',
    ...
    'ZAR',
    'ZMW'
]
*/

numbers()

var cc = require('currency-codes');
console.log(cc.numbers());

/*
[
    '784',
    '971',
    ...
    '710',
    '967'
]
*/

countries()

var cc = require('currency-codes');
console.log(cc.countries());

/*
[
    'united arab emirates',
    'afghanistan',
    ...
]
*/

data

var data = require('currency-codes/data');
console.log(data);

/*
[{
    code: 'AED',
    number: '784',
    digits: 2,
    currency: 'United Arab Emirates dirham',
    countries: ['united arab emirates']
}, {
    code: 'AFN',
    number: '971',
    digits: 2,
    currency: 'Afghan afghani',
    countries: ['afghanistan']
}, {
    ...
*/

publishDate

var cc = require('currency-codes');

console.log(cc.publishDate);

/*
2024-06-25
*/

Updating the data

Fetch the latest copy of ISO-4217 from the maintainer and update this library's currency data file.

$ npm run iso

> currency-codes@2.1.0 iso
> npm run iso:fetch-xml && npm run iso:ingest-xml


> currency-codes@2.1.0 iso:fetch-xml
> node scripts/fetch-iso-4217-xml.js

Downloaded https://www.six-group.com/dam/download/financial-information/data-center/iso-currrency/lists/list-one.xml to iso-4217-list-one.xml

> currency-codes@2.1.0 iso:ingest-xml
> node scripts/ingest-iso-4217-xml.js

Ingested iso-4217-list-one.xml into data.js
Wrote publish date to iso-4217-publish-date.js

Note: You may have to manually tweak the capitalization of some country's names.

License

MIT