---
title: "Calculadora de Acumulação USD/EUR para Intercâmbio"
method: POST
path: "/api/v1/calc/intercambio-acumular-divisas"
tags: ["calc", "nichos"]
---

# Calculadora de Acumulação USD/EUR para Intercâmbio

`POST /api/v1/calc/intercambio-acumular-divisas`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/intercambio-acumular-divisas`
- Auth: HTTP bearer

Quanto aportar mensalmente em BRL para chegar à meta em USD/EUR no intercâmbio. Considera inflação cambial, IOF (cronograma 2024-2029) e rendimento BRL durante a acumulação.

## Request body

- object
  - `metaUsdEurCents` integer, required: Meta de moeda estrangeira a acumular para o intercâmbio, expressa em centavos da moeda alvo. Ex: USD 5.000 → 500000 (em cents de USD); EUR 3.000 → 300000 (em cents de EUR).
  - `moedaAlvo` 'USD' | 'EUR': Moeda que será acumulada para o intercâmbio. "USD" = dólar americano; "EUR" = euro. Padrão: USD.
  - `mesesAteIntercambio` integer, required: Prazo em meses até a data do intercâmbio. Esse período é usado para calcular o aporte mensal necessário e estimar a variação cambial.
  - `metodoCompra` 'pix_transferencia' | 'cartao_credito_internacional' | 'papel_moeda_corretora': Método pelo qual a moeda estrangeira será adquirida. "pix_transferencia" = PIX/transferência cambial (IOF 1,1%); "cartao_credito_internacional" = cartão de crédito internacional (IOF decrescente até 2029); "papel_moeda_corretora" = compra de dinheiro físico em corretora (IOF 1,1%). Padrão: pix_transferencia.
  - `cambioAtualBrlPorMoeda` number, required: Cotação atual da moeda estrangeira em reais (BRL). Ex: se 1 USD = R$ 5,20, informe 5.2.
  - `inflacaoCambialEsperadaAnualPercent` number: Variação cambial anual esperada (depreciação do real em relação à moeda alvo). Em %. Ex: 4 = 4% ao ano de desvalorização do real. Valores negativos indicam apreciação do real. Padrão: 4.
  - `taxaInvestimentoBrlPercentAA` number: Taxa de rendimento anual da aplicação em BRL durante o período de acumulação (ex.: CDI, Selic). Em %. Ex: 12 = 12% ao ano. Padrão: 12.
  - `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)