---
title: "Calculadora Bola de Neve — Quitar Dívidas (Snowball × Avalanche)"
method: POST
path: "/api/v1/calc/bola-de-neve-dividas"
tags: ["calc", "financas"]
---

# Calculadora Bola de Neve — Quitar Dívidas (Snowball × Avalanche)

`POST /api/v1/calc/bola-de-neve-dividas`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/bola-de-neve-dividas`
- Auth: HTTP bearer

Simula a quitação de múltiplas dívidas usando o método Snowball (menor saldo primeiro — psicológico) ou Avalanche (maior taxa primeiro — matemático). Mostra prazo total, juros pagos e a sequência de quitação.

## Request body

- object
  - `dividas` object[], required: Lista de dívidas a serem quitadas (de 1 a 20 dívidas)
    - `nome` string, required: Nome da dívida para identificação (ex: "Cartão Nubank", "Empréstimo Caixa")
    - `saldoDevedorCents` integer, required: Saldo devedor atual desta dívida em centavos. Ex: R$ 5.000 → 500000
    - `taxaMensalPercent` number, required: Taxa de juros mensal desta dívida em % (0 a 25). Ex: 5 = 5% ao mês
    - `pagamentoMinimoCents` integer, required: Valor mínimo que você paga mensalmente nesta dívida em centavos. Ex: R$ 200 → 20000
  - `valorExtraPagamentoMensalCents` integer: Valor extra disponível por mês para pagar dívidas, além dos mínimos, em centavos. Ex: R$ 300 → 30000. Padrão: 0
  - `metodo` 'snowball' | 'avalanche': Método de quitação: "snowball" paga primeiro a dívida de menor saldo (motivação); "avalanche" paga primeiro a de maior taxa (menor custo total). Padrão: "avalanche"
  - `currentDate` string, date-time: ISO-8601 com offset. Default: tempo do servidor. Use pra reprodutibilidade / cache semantico.

## Response `200`

OK

- object
  - `ok` true, required
  - `data` object, required: Resultado dependente da calc — ver schema individual
  - `meta` object

## Other responses

- `422`: Input invalido (Zod parse falhou)
- `500`: Engine error

---

[API](https://skmtc.dev/calculas/apis/contai-api.md) · [All operations](https://skmtc.dev/calculas/apis/contai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/calculas/apis/contai-api/revisions/26a00749292b?raw)