---
title: "Calculadora: Alugar ou Comprar Imóvel?"
method: POST
path: "/api/v1/calc/aluguel-vs-compra-imovel"
tags: ["calc", "imoveis"]
---

# Calculadora: Alugar ou Comprar Imóvel?

`POST /api/v1/calc/aluguel-vs-compra-imovel`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/aluguel-vs-compra-imovel`
- Auth: HTTP bearer

Compare o custo real de alugar vs. comprar usando VPN e custo de oportunidade. Descubra o break-even e qual decisão faz mais sentido para o seu horizonte e perfil.

## Request body

- object
  - `valorImovelCents` integer, required: Valor de venda do imóvel que está sendo considerado para compra, em centavos. Ex: R$ 500.000 → 50000000
  - `entradaPercent` number: Percentual do valor do imóvel pago como entrada (sinal + FGTS). Ex: 20 = 20%. O restante é financiado. Padrão: 20%.
  - `taxaFinanciamentoAnualPercent` number: Taxa de juros anual do financiamento imobiliário. Ex: 10.5 = 10,5% ao ano. Consulte as taxas atuais nos principais bancos do mercado. Padrão: 10,5%.
  - `prazoFinanciamentoMeses` integer: Prazo total do financiamento em meses. Ex: 360 = 30 anos. Máximo: 420 meses (35 anos). Padrão: 360 meses.
  - `aluguelMensalCents` integer, required: Valor atual do aluguel mensal pago (ou que seria pago) pelo imóvel equivalente, em centavos. Ex: R$ 2.500 → 250000
  - `inflacaoAluguelAnualPercent` number: Taxa anual de reajuste esperada para o aluguel ao longo do horizonte de análise. Ex: 5 = 5% ao ano. Padrão: 5%.
  - `iptuMensalCents` integer: Valor mensal do IPTU do imóvel em centavos (valor anual dividido por 12). Ex: R$ 200/mês → 20000. Padrão: 0 (sem IPTU).
  - `condominioMensalCents` integer: Taxa de condomínio mensal em centavos, quando aplicável. Ex: R$ 800/mês → 80000. Padrão: 0 (casa ou sem condomínio).
  - `manutencaoAnualPercent` number: Percentual anual do valor do imóvel reservado para manutenção (reparos, pintura, instalações). Ex: 1 = 1% ao ano. Padrão: 1%.
  - `valorizacaoAnualPercent` number: Taxa anual de valorização esperada do imóvel. Ex: 4 = 4% ao ano. Use o índice FIPE-ZAP da região como referência. Padrão: 4%.
  - `taxaRendaFixaAnualPercent` number: Taxa de retorno anual da renda fixa (CDI/Selic), usada como custo de oportunidade da entrada e como taxa de desconto do valor presente. Ex: 10.5 = 10,5% ao ano. Padrão: 10,5%.
  - `horizonteAnos` integer: Período de análise em anos — por quantos anos você pretende ficar no imóvel (ou analisar a comparação). Ex: 10 = 10 anos. Padrão: 10 anos.
  - `custosAquisicaoPercent` number: Percentual do valor do imóvel referente aos custos de aquisição (ITBI, cartório, escritura). Ex: 3 = 3%. Padrão: 3%.
  - `custosVendaPercent` number: Percentual do valor de venda referente aos custos de alienação (corretagem, impostos). Ex: 6 = 6%. Padrão: 6%.
  - `custosTransacaoCompra` object[]: Custos one-shot adicionais de transação na COMPRA, agrupados por categoria (itbi, registro_cartorio, escritura, avaliacao, mip, dfi, vistoria_perícia, corretagem, taxa_cadastro, iof_financiamento, outro). Cada item: { categoria, valorCents, descricao? }. Esses valores SOMAM a custosAquisicaoPercent — use ESTE campo se quer detalhar item-a-item; caso contrário use o percentual agregado. Padrão: [].
    - `categoria` 'itbi' | 'registro_cartorio' | 'escritura' | 'avaliacao' | 'mip' | 'dfi' | 'vistoria_perícia' | 'corretagem' | 'taxa_cadastro' | 'iof_financiamento' | 'outro', required
    - `valorCents` integer, required: Valor em centavos. Ex: R$ 200 → 20000.
    - `descricao` string: Descrição livre do item (opcional, especialmente útil quando categoria = "outro"). Máx. 60 caracteres.
  - `irSobreAluguelPercent` number: Alíquota de IR (%) aplicada sobre o aluguel mensal — apenas se você for o LOCADOR (recebe aluguel) e quiser modelar o líquido. Carnê-Leão: faixas de 0–27,5% conforme tabela mensal IRPF. Default undefined = ignora IR (modelo simplificado, valor cheio do aluguel). Aceita 0–35%.
  - `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)