---
id: currency-symbols
version: "2.0.6"
license: MIT
license_treatment: permissive
maintenance: active
---

# currency-symbols — Get currency symbol by currency code

License: permissive · Maintenance: active · Downloads: 2.2M/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 2.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

currency code to symbol, ISO 4217 currency lookup, get currency symbol, currency symbol mapping, USD EUR GBP symbols, international currency codes, currency-data, iso-4217, zero-deps

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