---
title: "Calculadora de Renda Fixa em Dólar — Treasury, ETF Bond, CDB-USD"
method: POST
path: "/api/v1/calc/renda-fixa-em-dolar"
tags: ["calc", "nichos"]
---

# Calculadora de Renda Fixa em Dólar — Treasury, ETF Bond, CDB-USD

`POST /api/v1/calc/renda-fixa-em-dolar`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/renda-fixa-em-dolar`
- Auth: HTTP bearer

Compara renda fixa em dólar (Treasury, ETF Bond, CDB-USD) com CDI brasileiro. Considera IOF câmbio + carnê-leão sobre juros + GCAP sobre ganho cambial. Lei 11.033/04 + IN RFB 208/02.

## Request body

- object
  - `valorAplicadoUsdCents` integer, required: Valor investido em renda fixa denominada em dólar, em centavos de USD. Ex: USD 10.000 → 1000000.
  - `tipoAtivo` 'treasury_bond' | 'etf_bond' | 'cdb_dolar_brasileiro' | 'bond_corporativo', required: Tipo de ativo de renda fixa em dólar. "treasury_bond" = título do governo americano (T-Bond/T-Note — incide carnê-leão sobre juros + GCAP cambial); "etf_bond" = ETF de renda fixa (ex.: BND, TLT — mesmo tratamento fiscal); "cdb_dolar_brasileiro" = CDB em dólar emitido por banco brasileiro (tributação regressiva BR 15-22,5%, sem GCAP cambial separado); "bond_corporativo" = bônus de empresas privadas no exterior.
  - `taxaAnualPercentUsd` number, required: Taxa de juros anual do ativo em dólar. Em %. Ex: 4.5 = 4,5% ao ano (próximo ao Treasury 10y em 2026).
  - `prazoMeses` integer, required: Prazo do investimento em meses. Ex: 24 = 2 anos. Determina a alíquota de IR regressiva (para CDB-BR) e o total de carnê-leão acumulado.
  - `cambioAplicacao` number, required: Cotação do dólar (USD/BRL) na data da aplicação. Ex: 5.2 = R$ 5,20 por dólar. Usada para calcular o custo em BRL e o IOF câmbio.
  - `cambioResgateEstimado` number, required: Cotação estimada do dólar (USD/BRL) na data do resgate. Ex: 5.8 = R$ 5,80 por dólar. Determina o ganho cambial (GCAP) tributável.
  - `cdiAnualPercentReferencia` number: @market:cdi-anual Taxa CDI anual brasileira de referência para comparação com o ativo em dólar. Em %. Pré-preenchida com o CDI vigente (BCB SGS 12). Ex: 13 = 13% ao ano. Edite se quiser cenário diferente.
  - `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)