---
title: "Score de Exposição Patrimonial — 0 a 100"
method: POST
path: "/api/v1/calc/score-exposicao-patrimonial"
tags: ["calc", "nichos"]
---

# Score de Exposição Patrimonial — 0 a 100

`POST /api/v1/calc/score-exposicao-patrimonial`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/score-exposicao-patrimonial`
- Auth: HTTP bearer

Avalia o risco patrimonial em 4 eixos: concentração, proteção, liquidez e vulnerabilidades. Retorna score 0-100 (maior = mais protegido) + recomendações priorizadas. Versão F heurística (LLM I-puro fica para v2).

## Request body

- object
  - `patrimonioTotalCents` integer, required: Valor total do patrimônio líquido em centavos (soma de todos os ativos menos dívidas). Ex: R$ 1.000.000 → 100000000.
  - `percentImoveisProprios` number: Percentual do patrimônio alocado em imóveis próprios (residência, aluguel, terrenos). Em %. Ex: 40 = 40%. Alta concentração em imóveis reduz o score de liquidez. Padrão: 40.
  - `percentRendaFixa` number: Percentual do patrimônio alocado em renda fixa (Tesouro Direto, CDB, LCI, LCA, fundos DI etc.). Em %. Padrão: 30.
  - `percentRendaVariavel` number: Percentual do patrimônio alocado em renda variável brasileira (ações, FIIs, ETFs nacionais etc.). Em %. Padrão: 15.
  - `percentExterior` number: Percentual do patrimônio alocado no exterior (conta global, ETFs internacionais, Treasury, conta em dólar etc.). Em %. Contribui positivamente para diversificação e score. Padrão: 0.
  - `percentEmpresaPropria` number: Percentual do patrimônio representado pela empresa própria ou participação societária. Em %. Alta concentração em empresa própria aumenta o risco. Padrão: 15.
  - `temHolding` boolean: Se verdadeiro (true), o patrimônio está organizado em holding familiar (pessoa jurídica estruturada). Contribui positivamente para o score de proteção.
  - `temSeguroVida` boolean: Se verdadeiro (true), há apólice de seguro de vida ativa. Contribui positivamente para o score de proteção dos dependentes.
  - `temPlanejamentoSucessorio` boolean: Se verdadeiro (true), há planejamento sucessório formal (testamento, holding com doação de cotas, ou estrutura equivalente). Contribui positivamente para o score.
  - `temReservaEmergencia` boolean: Se verdadeiro (true), há reserva de emergência líquida (3-6 meses de despesas em renda fixa de liquidez diária). Contribui positivamente para o score.
  - `numeroDependentesFinanceiros` integer: Número de pessoas financeiramente dependentes do titular (filhos, cônjuge sem renda própria, pais etc.). Quanto maior, maior a vulnerabilidade. Padrão: 0.
  - `rendaPrincipalUnicaFonte` boolean: Se verdadeiro (true), a renda principal vem de uma única fonte (salário único ou empresa única). Reduz o score de vulnerabilidades. Se falso (false), há diversificação de fontes de renda.
  - `imoveisFinanciadosPercent` number: Percentual dos imóveis que ainda estão financiados (saldo devedor / valor de mercado dos imóveis). Em %. Ex: 50 = 50% do valor dos imóveis ainda é dívida. Alta alavancagem reduz o score. Padrão: 0.
  - `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)