---
id: py-moneyed
version: "3.0"
license: BSD
license_treatment: permissive
maintenance: dormant
---

# py-moneyed — Provides Currency and Money classes for use in your Python code.

License: permissive · Maintenance: dormant · Downloads: 1.1M/mo

## What it is and what it does

py-moneyed provides Money and Currency classes as a safer, more semantically correct way to handle monetary values in Python code. Instead of using floats (which suffer from precision errors) or raw Decimal objects (which lack currency context), you create Money instances tied to a specific currency and perform arithmetic on them as if they were numbers. The package depends on babel for localization and typing-extensions for type hints, and supports Python 3.7 through 3.11.

The package is designed to be used directly in financial and economics software, or subclassed for domain-specific extensions. It has been stable since its early releases and is classified as Mature, though development has been dormant since late 2022. With significant monthly downloads, it is a widely adopted solution for this problem in the Python ecosystem.

Use it for:

- Build financial applications that need to track money amounts with explicit currency types and avoid float precision errors
- Implement e-commerce systems where prices, totals, and transactions must preserve currency context
- Create accounting or bookkeeping tools that require correct arithmetic on monetary values across different currencies
- Develop APIs that serialize and deserialize monetary values with currency information intact

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Money and Currency classes for representing monetary values in Python with proper arithmetic and currency handling, avoiding pitfalls of using floats or raw Decimal objects.

Yes. The package solves a real problem (safe monetary representation) with a mature, stable API and low install friction. Dormant maintenance is a minor concern for a library this simple and well-established, but the lack of recent activity means you should verify that its currency support and arithmetic operations meet your specific needs before committing to it in new projects.

## Install

pip install py-moneyed
uv add py-moneyed
poetry add py-moneyed

## Installing py-moneyed

Before you install: Low install friction with only two lightweight runtime dependencies (babel and typing-extensions). Maintenance is dormant—last release was in 2022 and no commits since April 2024—but the package is classified as Mature and has been stable since its early releases.

License in practice: BSD license is permissive, allowing commercial and private use with minimal restrictions; suitable for most projects.

Quickstart:

pip install py-moneyed

from moneyed import Money, USD

five_dollars = Money(5, USD)

Verify before relying:

- Whether the package handles currency conversion or only represents fixed-currency amounts
- What arithmetic operations (addition, subtraction, multiplication) are supported between Money objects
- Whether the package provides exchange rate data or requires external sources

## Package facts

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

## Tags

money and currency classes, financial arithmetic python, decimal money handling, currency representation, monetary value abstraction, financial-data, currency-handling

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