---
title: "Calculadora de Portabilidade de Crédito"
method: POST
path: "/api/v1/calc/portabilidade-credito-economia"
tags: ["calc", "financas"]
---

# Calculadora de Portabilidade de Crédito

`POST /api/v1/calc/portabilidade-credito-economia`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/portabilidade-credito-economia`
- Auth: HTTP bearer

Simule se vale a pena portar seu financiamento imobiliário para outro banco com taxa menor. Calcule economia mensal, total pago e em quantos meses você recupera os custos da portabilidade.

## Request body

- object
  - `saldoDevedorCents` integer, required: Saldo devedor atual do financiamento em centavos. Ex: R$ 300.000 → 30000000.
  - `prazoRestanteMeses` integer, required: Número de parcelas restantes até o fim do financiamento. Ex: 240 = 20 anos.
  - `taxaAtualMensalPct` number, required: Taxa de juros mensal do financiamento atual (%). Ex: 0.875 = 0,875% ao mês (≈ 11% ao ano). Consulte o extrato ou contrato do banco.
  - `taxaNovaMensalPct` number, required: Taxa de juros mensal oferecida pelo banco destino na portabilidade (%). Deve ser menor que a taxa atual para a portabilidade compensar.
  - `custosPortabilidadeCents` integer: Custos totais estimados da portabilidade em centavos (avaliação do imóvel, cartório, ITBI se houver, etc.). Ex: R$ 3.500 → 350000. Padrão: 0 (sem custos).
  - `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)