Calculadora de LTV

O loan-to-value, quase sempre abreviado LTV na originação de hipotecas e no underwriting de crédito com garantia do imóvel, é a porcentagem com que um credor mede quanto de um bem avaliado está financiado. Esta calculadora aceita um valor de empréstimo e um valor de avaliação como números finitos, divide o primeiro pelo segundo, multiplica por cem e devolve o índice como porcentagem em um contrato JSON determinístico. Valor de imóvel zero ou negativo é rejeitado com invalid_input porque o quociente não está definido.

O que o LTV mede e como a porcentagem é formada

Esta ferramenta divide esses dois valores finitos, multiplica por cem e devolve ltv_percent. Como a divisão por zero não está definida, um property_value de zero falha com invalid_input em vez de Infinity, NaN ou um índice oco que um formulário poderia tratar como aprovação.

Contrato de entrada, forma da resposta e erros

Valor de imóvel negativo também é rejeitado, porque o LTV não está definido quando a avaliação é zero ou negativa. Valores de empréstimo negativos falham pela mesma família de motivos. Faça POST de um corpo JSON que informe loan_amount e property_value. loan_amount é o principal em uma só unidade monetária, um número finito maior ou igual a zero, com os alias loan, amount, principal e loan_principal. property_value é o valor avaliado na mesma moeda, um número finito que precisa ser estritamente maior que zero, com os alias value, appraised_value, home_value, appraisal e appraised_property_value. Cada campo numérico pode chegar como número JSON ou como string numérica. loan_amount ausente, property_value ausente, strings vazias, valores não finitos ou magnitude acima do limite declarado falham com invalid_input nomeando o campo e não são cobrados. Valor de imóvel zero é o erro que esta página existe para pegar: a mensagem contém property_value e must not be zero para que um formulário destaque esse controle em vez de um alerta global. No sucesso o corpo ecoa os dois insumos, devolve ltv_percent como a porcentagem arredondada e inclui uma string formula restabelecendo a identidade. Exemplo: loan_amount de trezentos e vinte mil contra property_value de quatrocentos mil produz ltv_percent de 80. Exemplo: um empréstimo de quatrocentos e cinquenta mil contra uma avaliação de quatrocentos mil produz um índice acima de cem, um caso claro de LTV alto em vez de um payload vazio silencioso. Combine a porcentagem com o teto do próprio programa se a minuta precisar de um sinal de aprovação ou reprovação; este endpoint calcula só a relação empréstimo-valor simples e não inventa um LTV combinado, um segundo gravame nem um resultado de seguro.

Onde uma calculadora de relação empréstimo-valor ganha o espaço

Mesas de compra e portais do tomador ranqueiam para calculadora relação empréstimo valor porque um comitê de crédito pensa na porcentagem LTV, não em um principal cru. Servicers e special servicers vivem do principal em aberto e da última avaliação; dividir o saldo pelo valor dá a mesma cifra de monitoramento sem forçar o analista a lembrar se uma célula já multiplicou por cem. Quem ensina matemática hipotecária pode semear exemplos de sala que falhem alto em avaliação zero em vez de imprimir Infinity, número que um aluno poderia ler como alavancagem infinita. Validação recusada não consome saldo. Mesas de home-equity e de cash-out usam a mesma identidade sobre um principal combinado novo; este endpoint ainda devolve o LTV simples, então uma planilha HELOC deve somar o saldo do primeiro gravame a loan_amount antes de chamar se o LTV combinado é o que a diretriz pede. Como a implementação é parse pura de nível A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002, sem tokens de modelo e sem rede de saída. Mantenha property_value estritamente positivo, fixe o campo ltv_percent arredondado nos testes e você obtém uma porcentagem empréstimo-valor reproduzível para widgets, módulos de curso e workers de borda sem montar um motor de política de crédito próprio. Scripts de carteira podem chamar o mesmo módulo em laço sobre muitas notas; cada item é um pedido, a unidade é item, e o caminho grátis do navegador permanece idêntico byte a byte à API, para que a prévia da página nunca minta sobre a cifra que será gravada depois de um save.