---
title: "Calcula em quanto tempo um aporte mensal chega a R$ 1 milhão (ou outra meta), quanto veio de juros, e o aporte necessário pra fechar em 10, 20 ou 30 anos. Taxa real escolhida pelo usuário."
method: GET
path: "/v1/calc/first-million"
tags: ["Calculadoras"]
---

# Calcula em quanto tempo um aporte mensal chega a R$ 1 milhão (ou outra meta), quanto veio de juros, e o aporte necessário pra fechar em 10, 20 ou 30 anos. Taxa real escolhida pelo usuário.

`GET /v1/calc/first-million`

## Request

- Base URL: `https://api.falazuki.com`
- URL: `https://api.falazuki.com/v1/calc/first-million`
- 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_contribution` number, required: Aporte mensal em R$
- `initial_amount` number: Quanto já tem investido em R$
- `annual_return` number: Rentabilidade anual em % (8 = padrão conservador de renda fixa líquida)
- `target_amount` number: A meta em R$ (padrão: 1 milhão)

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