---
title: "Calculadora de Taxa Efetiva vs Nominal"
method: POST
path: "/api/v1/calc/taxa-efetiva-vs-nominal"
tags: ["calc", "financas"]
---

# Calculadora de Taxa Efetiva vs Nominal

`POST /api/v1/calc/taxa-efetiva-vs-nominal`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/taxa-efetiva-vs-nominal`
- Auth: HTTP bearer

Converta entre taxa nominal e efetiva de juros, equivalência de períodos e percentual do CDI ou SELIC. Saiba quanto seu investimento realmente rende.

## Request body

- object
  - `modo` 'nominal_para_efetiva' | 'efetiva_para_nominal' | 'equivalencia_periodos' | 'percentual_para_taxa' | 'taxa_para_percentual', required: Modo de conversão: "nominal_para_efetiva" (converte taxa nominal em efetiva considerando capitalização), "efetiva_para_nominal" (o inverso), "equivalencia_periodos" (converte taxa de um período para outro, ex: mensal para anual), "percentual_para_taxa" (converte % do CDI/Selic em taxa ao ano), "taxa_para_percentual" (converte taxa em % do índice)
  - `taxaPercent` number: Taxa de juros de entrada em % (−99,99 a 9999). Usado nos modos 1, 2, 3 e 5. Ex: 12 = 12% ao período
  - `capitalizacao` 'diaria' | 'mensal' | 'trimestral' | 'semestral' | 'anual': Periodicidade de capitalização dos juros para os modos nominal_para_efetiva e efetiva_para_nominal: "diaria", "mensal", "trimestral", "semestral" ou "anual"
  - `periodoOrigem` 'diaria' | 'mensal' | 'trimestral' | 'semestral' | 'anual': Período de origem para equivalência de taxas (modo equivalencia_periodos): "diaria", "mensal", "trimestral", "semestral" ou "anual". Ex: "mensal" para converter taxa mensal
  - `periodoDestino` 'diaria' | 'mensal' | 'trimestral' | 'semestral' | 'anual': Período de destino para equivalência de taxas (modo equivalencia_periodos): "diaria", "mensal", "trimestral", "semestral" ou "anual". Ex: "anual" para obter a taxa anual equivalente
  - `referenciaIndex` 'cdi' | 'selic': Índice de referência para os modos percentual_para_taxa e taxa_para_percentual: "cdi" ou "selic"
  - `percentualIndice` number: Percentual do índice de referência (0 a 1000). Usado no modo percentual_para_taxa. Ex: 110 = 110% do CDI
  - `indiceAnualPercent` number: Taxa atual do índice de referência em % ao ano (0 a 100). Injetada pelo caller a partir do cache. Ex: 14.65 = CDI de 14,65% a.a.
  - `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)