calc
financas

Simulador de Rendimento do Tesouro Direto

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.

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

Request body

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)

valorInicialCentsinteger required

Valor a ser investido no título em centavos. Mínimo R$ 10 (1000 centavos). Ex: R$ 5.000 → 500000

taxaAnualPercentnumber

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%)

dataVencimentostring required

Data de vencimento do título no formato YYYY-MM-DD. Deve ser posterior à data atual. Ex: "2029-03-01"

ipca12mPercentnumber

@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.

aliquotaIrPercentnumber

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%

currentDatestring date-time

ISO-8601 com offset. Default: tempo do servidor. Use pra reprodutibilidade / cache semantico.

Response

OK

oktrue required
dataobject required

Resultado dependente da calc — ver schema individual

metaobject

Changes

No recorded changes to this operation across all 1 revision of this API.