---
id: ccy
version: "2.0.0"
license: BSD
license_treatment: permissive
maintenance: active
---

# ccy — Python currencies

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

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

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

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

## Tags

currency data library, financial currency metadata, currency lookup tool, currency information api, forex currency database, currency codes and details, trading currency reference, currency-data, financial-reference

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