currency-symbols

What it is and what it does

currency-symbols is a lightweight lookup library that translates ISO 4217 currency codes into their corresponding symbols. It covers all active ISO 4217 codes plus historical, cryptocurrency, and commodity codes, returning the symbol string or None for unknown codes. The library is fully type-hinted (PEP 561 compliant), has zero external dependencies, and is maintained as a pure Python package.

Typical usage is a single function call: pass a currency code (case-insensitive) and receive its symbol. It's designed for applications that need to display currency symbols in financial dashboards, e-commerce platforms, or data processing pipelines without pulling in a large dependency tree.

Use it for:

• Display currency symbols in e-commerce checkout flows or price displays without hardcoding symbol mappings.
• Format financial reports or data exports that need localized currency representation.
• Validate and normalize currency codes in payment processing or accounting integrations.
• Build currency conversion or exchange-rate tools that require symbol lookup alongside code handling.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Maps ISO 4217 currency codes to their symbols (USD → $, EUR → €, etc.), with support for active, historical, crypto, and commodity codes.

Yes. Zero dependencies, active maintenance, MIT license, and a focused, type-safe API make this a safe choice for any project needing currency symbol lookup. The low install friction and broad code coverage (active, historical, crypto, commodity) justify inclusion even in minimal environments.

Install

currency-symbols on PyPI

pip install currency-symbols

uv add currency-symbols

poetry add currency-symbols

Installing currency-symbols

Before you install

Low friction: pure Python wheel with zero runtime dependencies and active maintenance (last commit 2026-08-01, released 13 days ago).

License in practice

MIT license permits unrestricted use, modification, and distribution in commercial and private projects with minimal attribution requirements.

Quickstart

pip install currency-symbols

from currency_symbols import CurrencySymbols

CurrencySymbols.get_symbol("USD")  # '$'
CurrencySymbols.get_symbol("EUR")  # '€'

Requires Python 3.9 or later.

Verify before relying

• Exact coverage count for active, historical, crypto, and commodity codes beyond 'all active ISO 4217'.
• Whether the symbol lookup is case-insensitive for all code types or only standard ISO codes.

Package facts

Evidence: currency_symbols-2.0.6-py3-none-any.whl

Keywords: currency, currency-symbols, iso-4217, currency-code, symbols

Tags

More Libraries packages