---
title: "Investir no exterior — quanto rende em conta global em USD?"
method: POST
path: "/api/v1/calc/investimento-exterior"
tags: ["calc", "nichos"]
---

# Investir no exterior — quanto rende em conta global em USD?

`POST /api/v1/calc/investimento-exterior`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/investimento-exterior`
- Auth: HTTP bearer

Projeta patrimônio acumulado em USD via conta global, considera IOF na remessa (0,38%) e IR de 15% sobre ganho de capital no exterior (Lei 14.754/23). Conversão final em BRL.

## Request body

- object
  - `aporteInicialUsdCents` integer: Valor do aporte inicial depositado na conta global, em centavos de dólar (USD). Ex: USD 1.000 → 100000. Padrão: USD 1.000 (100000).
  - `aporteMensalUsdCents` integer: Valor do aporte mensal recorrente na conta global, em centavos de dólar (USD). Ex: USD 100/mês → 10000. Padrão: USD 100 (10000).
  - `prazoAnos` integer: Prazo total do investimento em anos. Ao final desse período a projeção de patrimônio é calculada. Padrão: 10.
  - `taxaAnualUsdPct` number: Rentabilidade anual esperada do investimento em dólar. Em %. Ex: 7 = 7% ao ano (retorno histórico médio do S&P 500). Padrão: 7.
  - `cotacaoUsdBrl` number: Cotação do dólar em reais (USD/BRL) usada para converter o patrimônio final para BRL. Ex: 5.2 = R$ 5,20 por dólar. Padrão: 5.2.
  - `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)
