Skip to main content

currency-symbols :money_with_wings:

CI Version Downloads LICENSE

Get the currency symbol for an ISO 4217 currency code — USD → $, EUR → €, INR → ₹.

  • Covers all active ISO 4217 codes, plus common historical, crypto and commodity codes
  • Zero dependencies
  • Fully typed (PEP 561, ships py.typed)
  • Python 3.9+

Installation

pip install currency-symbols

Usage

from currency_symbols import CurrencySymbols

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

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

CurrencySymbols.get_symbol("gbp")
# '£' — codes are case-insensitive

CurrencySymbols.get_symbol("XYZ")
# None — unknown codes return None

Changelog

All notable changes are documented in the CHANGELOG.

Contributing

Interested in contributing to this project? You can log any issues or suggestions related to this library here

Read our contributing guide on getting started with contributing to the codebase

Credits

Inspired by work of @bengourley on currency-symbol-map

License

MIT

Release files for currency-symbols 2.0.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for currency-symbols 2.0.6
File Size Uploaded
currency_symbols-2.0.6.tar.gz 5.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for currency-symbols 2.0.6
File Interpreter ABI Platform
currency_symbols-2.0.6-py3-none-any.whl Python 3 none any Details

Total release size: 10.2 kB

Release files / currency_symbols-2.0.6.tar.gz

Download URL currency_symbols-2.0.6.tar.gz
Size 5.0 kB
Tags Source
SHA-256 checksum
How to use checksums
e72e457cbc15067590c3e0090f80d7e46c9196ac68485c678e52aa4e7599d973
BLAKE2b-256 checksum
How to use checksums
e7d55be243c3fa01bd1c4f2b619e4817134f16426298de7b83b5c9fd80a2d53e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 1, 2026.

Transparency log

Release files / currency_symbols-2.0.6-py3-none-any.whl

Download URL currency_symbols-2.0.6-py3-none-any.whl
Size 5.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dc8bb1b0a84c9c0a1b1eb02e36573f86f3d9dc0d15a612458e9c6b167f5c6eef
BLAKE2b-256 checksum
How to use checksums
ee4de7c84d558c166582f13d9a278c317a77c994fb2a0f9fea9026d653464d6c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 1, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

2.0.6 This release

2 release files

2.0.5

2 release files

2.0.4

2 release files

2.0.3

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page