---
title: "Simulador de Lance em Consórcio — quanto dar para ser contemplado antes"
method: POST
path: "/api/v1/calc/simulador-lance-consorcio"
tags: ["calc", "financas"]
---

# Simulador de Lance em Consórcio — quanto dar para ser contemplado antes

`POST /api/v1/calc/simulador-lance-consorcio`

## Request

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

Calcule o valor ideal do lance, a economia gerada e o ROI de ofertar um lance no consórcio. Compare parcela sem lance vs com lance e descubra em quantos meses recupera o investimento.

## Request body

- object
  - `valorCreditoCents` integer, required: Valor da carta de crédito do consórcio em centavos. Ex: R$ 500.000 → 50000000
  - `prazoMeses` integer, required: Prazo total do grupo de consórcio em meses (12 a 420). Ex: 120 = 10 anos
  - `taxaAdmTotalPercent` number: Taxa de administração total do consórcio sobre o valor do crédito em % (0 a 50). Ex: 20 = 20%. Padrão: 20%
  - `lancePercentDisponivel` number, required: Percentual do valor do crédito que você tem disponível para dar de lance (0 a 99). Ex: 30 = 30% do crédito
  - `mesDesejadoContemplacao` integer: Mês alvo de contemplação. Se não informado, usa metade do prazo como referência.
  - `correcaoAnualConsorcioPercent` number: Correção anual aplicada às parcelas do consórcio (Lei 11.795/2008). Imobiliários costumam usar INCC (5-9% a.a.); veículos usam IPCA (4-5% a.a.). Padrão 6%. Passar 0 simula consórcio sem correção (não-realista).
  - `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)