---
title: "Simulador de FII — Renda Passiva Consolidada da Carteira"
method: POST
path: "/api/v1/calc/simulador-fii"
tags: ["calc", "financas"]
---

# Simulador de FII — Renda Passiva Consolidada da Carteira

`POST /api/v1/calc/simulador-fii`

## Request

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

Consolide a renda passiva mensal de uma carteira de Fundos Imobiliários (até 50 FIIs). Calcule o DY médio ponderado pelo valor investido em cada fundo e veja a contribuição individual de cada FII.

## Request body

- object
  - `fundos` object[], required: Lista de FIIs da carteira (1 a 50). Cada item: { codigo, dyAnualPercent, valorInvestidoCents }. BREAKING vs v1.x: antes era simulador temporal (patrimonioAtual+aporteMensal+DY+prazo). Para simular evolução de patrimônio com aportes mensais, use juros-compostos.
    - `codigo` string, required: Código do FII na B3 (1 a 10 caracteres). Ex: HGRE11, KNRI11, MXRF11.
    - `dyAnualPercent` number, required: Dividend yield anual do fundo em % (0 a 50). Ex: 9.5 = 9,5% a.a.
    - `valorInvestidoCents` integer, required: Valor atualmente investido nesse fundo em centavos. Ex: R$ 10.000 → 1000000.
    - `tipo` 'tijolo' | 'papel' | 'hibrido' | 'fof': Classificação do FII (audit fix v2.2). "tijolo" (padrão): imóvel físico — renda por aluguel. "papel": CRI/LCI/LH — sensível a juros. "hibrido": tijolo + papel. "fof" (Fundo de Fundos): cota de outros FIIs. Engine retorna alocação por perfil de risco.
  - `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)