calc
nichos

Score de Exposição Patrimonial — 0 a 100

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).

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

Request body

patrimonioTotalCentsinteger required

Valor total do patrimônio líquido em centavos (soma de todos os ativos menos dívidas). Ex: R$ 1.000.000 → 100000000.

percentImoveisPropriosnumber

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.

percentRendaFixanumber

Percentual do patrimônio alocado em renda fixa (Tesouro Direto, CDB, LCI, LCA, fundos DI etc.). Em %. Padrão: 30.

percentRendaVariavelnumber

Percentual do patrimônio alocado em renda variável brasileira (ações, FIIs, ETFs nacionais etc.). Em %. Padrão: 15.

percentExteriornumber

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.

percentEmpresaProprianumber

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.

temHoldingboolean

Se verdadeiro (true), o patrimônio está organizado em holding familiar (pessoa jurídica estruturada). Contribui positivamente para o score de proteção.

temSeguroVidaboolean

Se verdadeiro (true), há apólice de seguro de vida ativa. Contribui positivamente para o score de proteção dos dependentes.

temPlanejamentoSucessorioboolean

Se verdadeiro (true), há planejamento sucessório formal (testamento, holding com doação de cotas, ou estrutura equivalente). Contribui positivamente para o score.

temReservaEmergenciaboolean

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.

numeroDependentesFinanceirosinteger

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.

rendaPrincipalUnicaFonteboolean

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.

imoveisFinanciadosPercentnumber

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.

currentDatestring date-time

ISO-8601 com offset. Default: tempo do servidor. Use pra reprodutibilidade / cache semantico.

Response

OK

oktrue required
dataobject required

Resultado dependente da calc — ver schema individual

metaobject

Changes

No recorded changes to this operation across all 1 revision of this API.