---
id: iso4217
version: "1.16.20260101"
license: Public Domain
license_treatment: permissive
maintenance: active
---

# iso4217 — ISO 4217 currency data package for Python

License: permissive · Maintenance: active · Downloads: 701.7K/mo

## What it is and what it does

iso4217 wraps ISO 4217 currency data into a Python enum, letting you access currency metadata by code. Each currency entry includes its three-letter code, full name, and exponent (the number of decimal places in the currency's minor units—for example, USD has 2 for cents, JPY has 0). You can look up currencies by attribute (Currency.USD) or by string (Currency('USD')), and both forms return the same enum member.

The package is a thin, dependency-light data layer: it depends only on importlib-resources and works across Python 3.6 through 3.14. It's useful when you need reliable, standardized currency information without building your own lookup table or hitting an external API.

Use it for:

- Validate or normalize currency codes in financial applications or payment systems
- Determine decimal precision for currency formatting or rounding in multi-currency transactions
- Build currency selection dropdowns or autocomplete fields with standard ISO codes and names
- Localize or display currency names in internationalized applications

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides ISO 4217 currency data as a Python enum, allowing you to look up currency codes, names, and exponent values (minor unit precision) programmatically.

Yes. This is a stable, zero-vulnerability, permissive-licensed data package with low install friction and active maintenance. Install it if you need reliable ISO 4217 currency lookups; the enum interface is clean and the dependency footprint is minimal.

## Install

pip install iso4217
uv add iso4217
poetry add iso4217

## Installing iso4217

Before you install: Low friction: pure Python wheel with a single lightweight dependency (importlib-resources). Active maintenance with a recent release and no known vulnerabilities.

License in practice: Public Domain license means no restrictions on use, modification, or distribution—you can use this freely in any project without license compliance concerns.

Quickstart:

pip install iso4217

from iso4217 import Currency

usd = Currency.USD
print(usd.code)  # 'USD'
print(usd.currency_name)  # 'US Dollar'
print(usd.exponent)  # 2

Verify before relying:

- Whether the enum includes all current ISO 4217 currencies or if there are known omissions
- How frequently the package updates when ISO 4217 standards change

## Package facts

- License: Public Domain (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 701.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

iso 4217 currency codes, currency data python, currency enum lookup, iso currency information, currency exponent minor units, currency code resolver, international currency data, currency-data, i18n, financial

[View on SkillFed](https://skillfed.io/packages/iso4217) · [View on PyPI](https://pypi.org/project/iso4217/)