---
title: "Net Present Value (NPV)"
method: POST
path: "/v1/tools/compute_npv"
tags: ["TODO_TAGS_REVIEW"]
---

# Net Present Value (NPV)

`POST /v1/tools/compute_npv`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/compute_npv`
- Auth: none declared

Net present value of a cash flow series, discounted at a declared periodic rate. Accepts either caller-supplied period offsets or dated cash flows converted to years under a declared day-count convention (30/360, ACT/360, ACT/365, or a simplified ACT/ACT). Deterministic pow via Taylor-series exp/ln, no engine transcendentals. Foundation primitive for downstream valuation and lease/loan analytics.

**Tool URL:** https://ainumbers.co/chaingraph/art-324-tvm-npv.html
**AP2/Policy Mandate export:** yes

## Request body

- object
  - `cash_flows` unknown[], required
    - unknown
  - `day_count_convention` unknown, required
  - `discount_rate_pct` number: Percentage value
  - `mode` unknown, required
  - `valuation_date` unknown, required

## Response `200`

Successful tool execution result

- object
  - `day_count_convention` string
  - `discount_rate_pct` integer
  - `mode` string
  - `note` string
  - `npv` number
  - `num_cash_flows` integer
  - `regulatory_basis` string
  - `total_undiscounted` integer

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)