Metadata-Version: 2.4
Name: calcfi-apr-apy
Version: 0.1.0
Summary: Convert between APR (simple annual rate) and APY (effective annual yield including compounding). MIT.
Project-URL: Homepage, https://calcfi.app/calculators/apr-vs-apy
Project-URL: Documentation, https://calcfi.app/calculators/apr-vs-apy
Project-URL: Repository, https://github.com/jeresalmisto/calcfi-apr-apy
Project-URL: Source code, https://github.com/jeresalmisto/calcfi-apr-apy
Project-URL: Bug tracker, https://github.com/jeresalmisto/calcfi-apr-apy/issues
Project-URL: Live calculator, https://calcfi.app/calculators/apr-vs-apy
Project-URL: Parent dataset (DOI), https://doi.org/10.6084/m9.figshare.32332290
Project-URL: CalcFi homepage, https://calcfi.app
Project-URL: Open data, https://calcfi-open-data-4a2bc1.gitlab.io/
Author-email: Jere Salmisto <jere.salmisto@gmail.com>
Maintainer-email: Jere Salmisto <jere.salmisto@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: annual-percentage-rate,annual-percentage-yield,apr,apy,calcfi,compound-interest,finance
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Office/Business :: Financial :: Accounting
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Mathematics
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# calcfi-apr-apy

> Convert between APR (simple annual rate) and APY (effective annual yield including compounding). MIT.

**CalcFi APR vs APY Conversion** — a single-purpose, MIT-licensed helper for Convert APR to APY and vice versa for any compounding frequency. APY = (1 + APR/n)^n − 1. Continuous compounding via e^APR − 1.

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![ORCID](https://img.shields.io/badge/ORCID-0009--0000--0916--8684-A6CE39)](https://orcid.org/0009-0000-0916-8684)
[![CalcFi](https://img.shields.io/badge/calcfi.app-Live%20Calculator-blue)](https://calcfi.app/calculators/apr-vs-apy)

## What this does

Convert APR to APY and vice versa for any compounding frequency. APY = (1 + APR/n)^n − 1. Continuous compounding via e^APR − 1.

**Formula** — APY conversion:

```
APY = (1 + APR/n)^n − 1   |   APR = n × [(1 + APY)^(1/n) − 1]
```

**Primary source**: [Truth in Lending Act / Regulation Z (12 CFR Part 1026)](https://www.consumerfinance.gov/rules-policy/regulations/1026/)

## Install

```bash
pip install calcfi-apr-apy
```

## Usage

```python
from calcfi_apr_apy import apr_to_apy, apy_to_apr

# 6% APR with monthly compounding
apr_to_apy(0.06, 12)  # 0.0617 (6.17% APY)
```

## Live calculator

Try the interactive web calculator with full UI at **[https://calcfi.app/calculators/apr-vs-apy](https://calcfi.app/calculators/apr-vs-apy)** — no signup required.

## Why this package exists

Most personal-finance calculators are buried in advertising-heavy lead-generation sites. The math is freely published by federal agencies and textbooks, but the implementations are wrapped in proprietary opaque code. **[CalcFi](https://calcfi.app)** publishes these utility libraries to make every formula:

1. **Reproducible** — show the math
2. **Cited** — link to primary sources
3. **Free** — MIT license, no paid tier
4. **Auditable** — every line of code is open source

The math here is undergraduate-level. The contribution is the citation discipline and the open distribution.


## Part of the CalcFi ecosystem

This package is one of 8 single-purpose helper utilities. Cross-mesh:

### Sibling Python packages

- [calcfi-mortgage-payment](https://pypi.org/project/calcfi-mortgage-payment/) — Standard amortizing-loan monthly payment formula. Free, cited, MIT.
- [calcfi-compound-interest](https://pypi.org/project/calcfi-compound-interest/) — Compound interest with periodic contributions. Future value, present value, time-to-target. Free, MIT.
- [calcfi-rule-of-72](https://pypi.org/project/calcfi-rule-of-72/) — Rule of 72 — approximate years to double an investment at a given rate. Plus exact ln(2) version. MIT.
- [calcfi-real-return](https://pypi.org/project/calcfi-real-return/) — Inflation-adjusted (real) return from nominal return. Formula: real = (1+nominal)/(1+inflation) − 1. MIT.
- [calcfi-amortization](https://pypi.org/project/calcfi-amortization/) — Generate a full amortization schedule for a fixed-rate loan: payment, principal, interest, balance per period. MIT.
- [calcfi-tax-bracket](https://pypi.org/project/calcfi-tax-bracket/) — US federal income tax bracket math — marginal rate, effective rate, total tax owed. 2024-2026 brackets per IRS Rev. Proc. MIT.
- [calcfi-debt-payoff](https://pypi.org/project/calcfi-debt-payoff/) — Snowball vs avalanche debt payoff strategies. Compute months and total interest. MIT.

### Sibling npm packages

- [calcfi-mortgage-payment](https://www.npmjs.com/package/calcfi-mortgage-payment) — Standard amortizing-loan monthly payment formula. Free, cited, MIT.
- [calcfi-compound-interest](https://www.npmjs.com/package/calcfi-compound-interest) — Compound interest with periodic contributions. Future value, present value, time-to-target. Free, MIT.
- [calcfi-rule-of-72](https://www.npmjs.com/package/calcfi-rule-of-72) — Rule of 72 — approximate years to double an investment at a given rate. Plus exact ln(2) version. MIT.
- [calcfi-real-return](https://www.npmjs.com/package/calcfi-real-return) — Inflation-adjusted (real) return from nominal return. Formula: real = (1+nominal)/(1+inflation) − 1. MIT.
- [calcfi-amortization](https://www.npmjs.com/package/calcfi-amortization) — Generate a full amortization schedule for a fixed-rate loan: payment, principal, interest, balance per period. MIT.
- [calcfi-tax-bracket](https://www.npmjs.com/package/calcfi-tax-bracket) — US federal income tax bracket math — marginal rate, effective rate, total tax owed. 2024-2026 brackets per IRS Rev. Proc. MIT.
- [calcfi-debt-payoff](https://www.npmjs.com/package/calcfi-debt-payoff) — Snowball vs avalanche debt payoff strategies. Compute months and total interest. MIT.

### Companion data

The mortgage rate, inflation, Treasury yield, and macro data used to validate
these calculators are published as **[CalcFi Open Data](https://calcfi-open-data-4a2bc1.gitlab.io/)** —
34 free CC BY 4.0 time series, 117,956 observations, 5 permanent DOIs.

- [CalcFi Open Data on Hugging Face](https://huggingface.co/datasets/iizy/calcfi-open-data)
- [Python `calcfidata` SDK](https://pypi.org/project/calcfidata/)
- [npm `calcfidata` SDK](https://www.npmjs.com/package/calcfidata)
- [Live SQL endpoint (Datasette)](https://calcfi-open-data.vercel.app/)
- [DOI 10.6084/m9.figshare.32332290](https://doi.org/10.6084/m9.figshare.32332290)

### Calculators on CalcFi (free, no signup)

Every formula in these packages has a live web calculator at [calcfi.app](https://calcfi.app):

- [Mortgage Payment](https://calcfi.app/calculators/mortgage-payment)
- [Compound Interest](https://calcfi.app/calculators/compound-interest)
- [Tax Bracket](https://calcfi.app/calculators/tax-bracket)
- [Amortization Schedule](https://calcfi.app/calculators/mortgage-amortization)
- [APR vs APY](https://calcfi.app/calculators/apr-vs-apy)
- [Rule of 72](https://calcfi.app/calculators/rule-of-72)
- [Inflation-Adjusted Return](https://calcfi.app/calculators/inflation-adjusted-return)
- [Debt Payoff](https://calcfi.app/calculators/debt-payoff)


## License

MIT. Author: **Jere Salmisto** ([ORCID 0009-0000-0916-8684](https://orcid.org/0009-0000-0916-8684)), founder of [CalcFi](https://calcfi.app). Based in Helsinki, Finland.

## Citation

If you cite this package in research:

```
Salmisto, J. (2026). calcfi-apr-apy: CalcFi APR vs APY Conversion.
DOI: 10.6084/m9.figshare.32332290 (parent CalcFi Open Data dataset).
Available: https://calcfi.app/calculators/apr-vs-apy
```

Or use the [CITATION.cff](https://calcfi-open-data-4a2bc1.gitlab.io/) on the parent dataset for the BibTeX entry.
