ccy

What it is and what it does

ccy is a Python module that compiles and exposes a dictionary of currency objects, each containing metadata useful for financial analysis. It wraps currency information in a programmatic interface and offers both a Python API and a command-line tool for querying. The module depends on pycountry for country/currency standards, pydantic for data validation, python-dateutil for date handling, and typing-extensions for type hints.

The package is intended for developers who need structured access to currency data in financial applications. It supports querying currencies via the CLI (ccys show) or programmatically in code. An optional holidays extra provides trading centre information, though the core module covers currency fundamentals. The fact sheet notes that not all world currencies are supported, so coverage should be verified for specialized use cases.

Use it for:

• Query currency codes, symbols, and metadata in financial analysis or trading applications.
• Build a CLI tool to inspect available currencies and their properties without writing custom data structures.
• Integrate standardized currency information into a backend service that handles multi-currency transactions.
• Reference trading centre holidays and financial calendars when installing the holidays extra.

Worth the install?

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

Provides a dictionary of currency objects with financial metadata, accessible programmatically or via a command-line tool for querying currency information.

Yes, if you need a lightweight, permissively licensed currency reference library with low install friction. The active maintenance status and lack of known vulnerabilities make it safe to adopt. Verify that the supported currency set covers your use case before committing, as coverage is incomplete.

Install

ccy on PyPI

pip install ccy

uv add ccy

poetry add ccy

Installing ccy

Before you install

Low install friction with a pure-Python wheel and four straightforward runtime dependencies. Actively maintained as of the latest release.

License in practice

BSD license is permissive, allowing use in both open-source and proprietary projects with minimal restrictions.

Quickstart

pip install ccy

import ccy
# Access currency objects from the compiled dictionary
currency = ccy.currency('USD')

Requires Python 3.11 or later.

Verify before relying

• Whether the currency dictionary is comprehensive enough for your specific use case, as the description notes not all world currencies are supported yet.
• Whether trading centre data via the holidays extra is actively maintained and complete.

Package facts

Evidence: ccy-2.0.0-py3-none-any.whl

Tags

More Utilities packages