Calculadora FIRE

Uma taxa de retirada nula não consegue dimensionar uma carteira e falha com invalid_input.

O número FIRE e a taxa de retirada segura

A identidade usada pelo estudo Trinity e pela maior parte dos textos sobre uma taxa de retirada segura é uma só divisão: target_portfolio equivale a annual_expenses dividido por (withdrawal_rate sobre cem). Você envia annual_expenses e withdrawal_rate de forma explícita para que o resultado seja função das suas hipóteses, não de uma regra de bolso oculta. A resposta ecoa as duas entradas, informa withdrawal_decimal (a taxa dividida por cem), informa expense_multiple e devolve target_portfolio arredondado half-up a duas casas para que as telas de moeda permaneçam estáveis entre ambientes. Uma taxa nula implicaria uma carteira infinita; esse pedido é rejeitado em vez de devolver Infinity, e é o caminho invalid_input exigido desta capacidade.

Anos até a independência com poupança e retorno esperado

A poupança atual capitaliza a annual_return por cento ao ano. Quando o retorno é nulo, years equivale ao gap restante dividido por annual_savings. Quando o retorno não é nulo, a identidade é alvo igual a atual vezes (um mais r) elevado a n mais o aporte vezes ((um mais r) elevado a n menos um) sobre r, com r igual a annual_return sobre cem. Se a poupança atual já cobre ou supera o alvo, years vale zero e already_independent é true. Se aportes e retorno não conseguem fechar a brecha —por exemplo um retorno nulo sem poupança, ou um retorno negativo cujo equilíbrio fica abaixo do alvo— a tarefa falha com invalid_input em vez de emitir Infinity.

Contrato de entrada, erros e onde uma API FIRE se justifica

Despesas ou saldos de poupança negativos são rejeitados. O caminho de erro exigido é uma taxa de retirada que não seja maior que zero: o zero não consegue dimensionar uma carteira FIRE e não é faturado. Exemplo: quarenta mil de despesas a quatro por cento com cem mil poupados, trinta mil de poupança anual e um retorno de sete por cento produzem um alvo de um milhão e um years finito pela identidade da anuidade. Mantenha a taxa de retirada positiva, fixe o alvo e os anos arredondados nos testes, e você obtém um número de independência e um calendário reproduzíveis para widgets, módulos de curso e workers na borda. Envie por POST um corpo JSON com cinco números finitos obrigatórios. annual_expenses é o gasto anual planejado em unidades monetárias, maior ou igual a zero; aceitam-se os aliases expenses, spending, yearly_expenses e annual_spend. withdrawal_rate é a taxa de retirada segura em percentual, não em fração: envie 4 para 4 por cento, não 0.04. Aceitam-se os aliases swr, swr_percent e safe_withdrawal_rate. current_savings é o patrimônio investido hoje; aceitam-se os aliases current, nest_egg, portfolio e principal. annual_savings é o valor acrescentado no fim de cada ano; aceitam-se os aliases contribution, savings e yearly_savings. annual_return é o retorno percentual esperado por ano, que pode ser zero (sem crescimento real) mas deve permanecer acima de menos cem para que um mais r fique positivo; aceitam-se os aliases return_percent, growth_rate e expected_return. Cada campo pode chegar como número JSON ou como cadeia numérica. Campos ausentes, cadeias vazias, booleanos e valores não finitos falham com invalid_input nomeando o campo. Em caso de sucesso o corpo inclui as entradas ecoadas, withdrawal_decimal, expense_multiple, target_portfolio, shortfall, years, already_independent e uma cadeia curta de fórmula.