---
title: "Calculadora de VPL e TIR — Análise de Viabilidade de Investimento"
method: POST
path: "/api/v1/calc/vpl-tir"
tags: ["calc", "financas"]
---

# Calculadora de VPL e TIR — Análise de Viabilidade de Investimento

`POST /api/v1/calc/vpl-tir`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/vpl-tir`
- Auth: HTTP bearer

Calcule o Valor Presente Líquido (VPL) e a Taxa Interna de Retorno (TIR) de qualquer projeto ou investimento. Descubra se o negócio vale a pena e em quanto tempo você recupera o capital investido.

## Request body

- object
  - `fluxosCents` integer[], required: Array de fluxos de caixa em centavos (mínimo 2, máximo 25 períodos). O primeiro elemento (t=0) é o investimento inicial (valor negativo). Os demais são os retornos esperados por período. Ex: [-10000000, 300000, 300000, 500000] = investimento R$ 100k e retornos mensais
  - `taxaDescontoAnualPercent` number, required: Taxa de desconto anual (custo de oportunidade do capital) em % ao ano. Representa o mínimo de retorno exigido. Ex: 15 = 15% a.a. Para projetos conservadores use CDI (≈14,65% a.a. em 2026); para empreendimentos use 20-30%
  - `periodicidade` 'mensal' | 'anual': Periodicidade dos fluxos de caixa: "anual" (cada fluxo representa 1 ano) ou "mensal" (cada fluxo representa 1 mês). Define se a taxa de desconto é convertida para base mensal. Padrão: "anual"
  - `currentDate` string, date-time: ISO-8601 com offset. Default: tempo do servidor. Use pra reprodutibilidade / cache semantico.

## Response `200`

OK

- object
  - `ok` true, required
  - `data` object, required: Resultado dependente da calc — ver schema individual
  - `meta` object

## Other responses

- `422`: Input invalido (Zod parse falhou)
- `500`: Engine error

---

[API](https://skmtc.dev/calculas/apis/contai-api.md) · [All operations](https://skmtc.dev/calculas/apis/contai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/calculas/apis/contai-api/revisions/26a00749292b?raw)