numpy-financial 1.0.0

The numpy-financial package is a collection of elementary financial functions.

The financial functions in NumPy are deprecated and eventually will be removed from NumPy; see NEP-32 for more information. This package is the replacement for the deprecated NumPy financial functions.

The source code for this package is available at

The importable name of the package is numpy_financial. The recommended alias is npf. For example,

>>> import numpy_financial as npf
>>> npf.irr([-250000, 100000, 150000, 200000, 250000, 300000])


fv(rate, nper, pmt, pv[, when])

Compute the future value.

ipmt(rate, per, nper, pv[, fv, when])

Compute the interest portion of a payment.


Return the Internal Rate of Return (IRR).

mirr(values, finance_rate, reinvest_rate)

Modified internal rate of return.

nper(rate, pmt, pv[, fv, when])

Compute the number of periodic payments.

npv(rate, values)

Returns the NPV (Net Present Value) of a cash flow series.

pmt(rate, nper, pv[, fv, when])

Compute the payment against loan principal plus interest.

ppmt(rate, per, nper, pv[, fv, when])

Compute the payment against loan principal.

pv(rate, nper, pmt[, fv, when])

Compute the present value.

rate(nper, pmt, pv, fv[, when, guess, tol, …])

Compute the rate of interest per period.

Release Notes


  • The transition of the source code from NumPy to this package is complete.


  • Removed the use of numpy.core.overrides.array_function_dispatch to create wrappers of the financial functions.

  • Support NumPy versions back to 1.15.


  • This is the initial release of numpy-financial. The functions were copied from NumPy 1.17.