---
title: "Fundo de Emergência — quanto guardar e em quanto tempo"
method: POST
path: "/api/v1/calc/fundo-de-emergencia"
tags: ["calc", "financas"]
---

# Fundo de Emergência — quanto guardar e em quanto tempo

`POST /api/v1/calc/fundo-de-emergencia`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/fundo-de-emergencia`
- Auth: HTTP bearer

Calcule sua reserva ideal ajustada por perfil (CLT, PJ, autônomo) e dependentes. Veja o gap atual, quanto tempo leva para concluir e quanto aportar para chegar no prazo certo.

## Request body

- object
  - `gastoMensalEssencial` object[]: Gastos mensais essenciais agrupados por categoria (moradia, alimentacao, transporte, saude, etc.). Cada item: { categoria, valorCents, descricao? }. Soma de todos os itens = gasto essencial total. Use "outro" + descrição livre para casos não cobertos.
    - `categoria` 'moradia' | 'alimentacao' | 'transporte' | 'saude' | 'educacao' | 'lazer' | 'vestuario' | 'seguros' | 'servicos_profissionais' | '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.
  - `mesesReservaAlvo` integer: Número de meses de gastos que você quer acumular como reserva (3 a 24). Ex: 6 = 6 meses de gastos. Padrão: 6
  - `rendaMensalCents` integer: Renda mensal líquida em centavos. Usada para calcular o aporte sugerido. Ex: R$ 5.000 → 500000. Padrão: R$ 5.000
  - `tipoVinculo` 'clt' | 'pj' | 'autonomo' | 'aposentado' | 'freelancer': Tipo de vínculo profissional: "clt" (empregado formal), "pj" (pessoa jurídica), "autonomo" (profissional autônomo), "aposentado" (beneficiário do INSS), "freelancer" (trabalho eventual). Afeta o número de meses recomendado. Padrão: "clt"
  - `dependentes` integer: Número de pessoas financeiramente dependentes de você (filhos, cônjuge, pais, etc.). Cada dependente adiciona à reserva recomendada. Padrão: 0
  - `valorJaAcumuladoCents` integer: Valor já acumulado para a reserva de emergência em centavos. Ex: R$ 5.000 → 500000. Padrão: 0
  - `aporteMensalCents` integer: Valor que você consegue aportar por mês para construir a reserva em centavos. Ex: R$ 500 → 50000. Padrão: 0
  - `taxaLiquidezPercent` number: Taxa de rendimento anual esperada da reserva em % (0 a 15). Use apenas aplicações com liquidez diária (Tesouro Selic, CDB com liquidez diária). Ex: 10 = 10% a.a. Padrão: 10%
  - `prazoConstrucaoReservaMeses` integer: Prazo em meses que você deseja para concluir a reserva (1 a 120). Se não informado, usa o número de meses da própria reserva-alvo como prazo padrão
  - `eventosOpcionais` object[]: Entradas anuais extras que aceleram a reserva: 13º salário aplicado, restituição IR, herança, venda de bem, bônus extra, etc. Cada item escolhe tipo (aporte_extra, rendimento_extra, etc.), frequência (anual/semestral/única/irregular) e valor. Engine deduz a soma anual do gap, reduzindo prazo de conclusão e aporte mensal sugerido. Padrão []. Form começa vazio — user adiciona conforme precisa.
    - `tipo` 'aporte_extra' | 'retirada' | 'rendimento_extra' | 'gasto_unico' | 'outro', required
    - `modoValor` 'absoluto' | 'percent_salario' | 'percent_renda'
    - `valorCents` integer
    - `percent` number
    - `frequencia` 'mensal' | 'bimestral' | 'trimestral' | 'semestral' | 'anual' | 'unica' | 'irregular'
    - `descricao` string: Rótulo livre do user (ex: "PPR meta 2026", "Bônus retenção").
    - `monthsApplicable` integer[]
    - `ativo` boolean
  - `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)