---
title: "Simulador de Rendimento do Tesouro Direto"
method: POST
path: "/api/v1/calc/tesouro-direto-rendimento"
tags: ["calc", "financas"]
---

# Simulador de Rendimento do Tesouro Direto

`POST /api/v1/calc/tesouro-direto-rendimento`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/tesouro-direto-rendimento`
- Auth: HTTP bearer

Simule o rendimento líquido do seu investimento no Tesouro Direto. Calcula Tesouro Selic, Prefixado e IPCA+ com capitalização composta, IR regressivo e taxa de custódia B3.

## Request body

- object
  - `tipoTitulo` 'selic' | 'prefixado' | 'ipca_mais', required: Tipo do título do Tesouro Direto: "selic" (Tesouro Selic/LFT — rendimento diário pela Selic), "prefixado" (Tesouro Prefixado/LTN — taxa fixada na compra), "ipca_mais" (Tesouro IPCA+/NTN-B — IPCA + spread real, proteção contra inflação)
  - `valorInicialCents` integer, required: Valor a ser investido no título em centavos. Mínimo R$ 10 (1000 centavos). Ex: R$ 5.000 → 500000
  - `taxaAnualPercent` number: Taxa anual do título em % ao ano. Para Tesouro Selic: opcional — se omitido, o engine usa a Selic vigente (snapshot BCB). Para Prefixado e IPCA+: obrigatório (taxa contratada / spread real). Ex: 14.75 (Selic), 13.5 (Prefixado), 7.0 (IPCA+ → IPCA + 7%)
  - `dataVencimento` string, required: Data de vencimento do título no formato YYYY-MM-DD. Deve ser posterior à data atual. Ex: "2029-03-01"
  - `ipca12mPercent` number: @market:ipca-12m IPCA acumulado nos últimos 12 meses em % ao ano (−10 a 50). Pré-preenchido com o IPCA 12m vigente (IBGE / BCB SGS 433). Usado apenas para Tesouro IPCA+ — compõe a taxa total com o spread; ignorado nos demais tipos. Ex: 4.5 = IPCA de 4,5% a.a.
  - `aliquotaIrPercent` number: Alíquota de IR sobre os rendimentos em % (tabela regressiva Lei 11.033/2004): 22,5% até 180 dias; 20% de 181 a 360 dias; 17,5% de 361 a 720 dias; 15% acima de 720 dias. Para resgates no vencimento (> 2 anos), use 15. Padrão: 15%
  - `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)