---
title: "Calcula o patrimônio necessário pra viver de dividendos: renda mensal desejada dividida pelo dividend yield da carteira, a renda que o patrimônio atual já gera, e em quanto tempo o aporte mensal chega lá."
method: GET
path: "/v1/calc/dividend-income-goal"
tags: ["Calculadoras"]
---

# Calcula o patrimônio necessário pra viver de dividendos: renda mensal desejada dividida pelo dividend yield da carteira, a renda que o patrimônio atual já gera, e em quanto tempo o aporte mensal chega lá.

`GET /v1/calc/dividend-income-goal`

## Request

- Base URL: `https://api.falazuki.com`
- URL: `https://api.falazuki.com/v1/calc/dividend-income-goal`
- Auth: none declared

Sem query params, devolve o schema de entrada em vez de calcular — útil pra descobrir o endpoint pelo navegador.

## Query parameters

- `monthly_income` number, required: Renda mensal desejada em R$
- `dividend_yield` number: Dividend yield anual da carteira em % (padrão 8)
- `current_portfolio` number: Patrimônio já investido em R$
- `monthly_contribution` number: Aporte mensal em R$
- `annual_return` number: Rentabilidade total anual na acumulação em % (padrão 10)

## Response `200`

Resultado do cálculo

- object: Campos variam por calculador. `currency` está sempre presente.
  - `currency` string

## Other responses

- `400`: Entrada inválida
- `503`: Taxas indisponíveis na fonte

---

[API](https://skmtc.dev/falazuki/apis/falazuki-finance-api.md) · [All operations](https://skmtc.dev/falazuki/apis/falazuki-finance-api/llms.txt) · [OpenAPI document](https://skmtc.dev/falazuki/apis/falazuki-finance-api/revisions/ad442f36c098?raw)