Calculadora de IOF — Investimentos, Câmbio e Crédito

Calcule o IOF sobre resgates de renda fixa (tabela regressiva de 30 dias), operações de câmbio (viagem, cartão, remessas) e operações de crédito pessoal. Descubra quanto você paga de imposto e quando vale a pena esperar mais dias para resgatar.

post/api/v1/calc/iof-investimentos-cambio

Request

Base URL: https://api.calculas.com.br
URL: https://api.calculas.com.br/api/v1/calc/iof-investimentos-cambio
Auth: HTTP bearer

Request body

modalidade'investimento' | 'cambio' | 'credito' required

Tipo de operação financeira: "investimento" para resgate de renda fixa (CDB, fundo, Tesouro Direto etc.); "cambio" para compra de moeda estrangeira, cartão no exterior ou remessas; "credito" para empréstimo ou financiamento pessoal.

valorAplicadoCentsinteger

Valor em centavos. Valor principal aplicado na data da aplicação, antes de qualquer rendimento. Obrigatório quando a modalidade é "investimento". Ex: R$ 10.000 → 1000000.

rendimentoBrutoCentsinteger

Valor em centavos. Rendimento bruto auferido sobre o principal até a data do resgate, antes de descontar IOF e IR. Obrigatório quando a modalidade é "investimento". Ex: R$ 150 → 15000.

prazoResgateDiasinteger

Número de dias corridos entre a data da aplicação e a data do resgate. Determina a alíquota de IOF pela tabela regressiva (96% no dia 1, zero a partir do dia 30). Obrigatório quando a modalidade é "investimento". Ex: 15 dias.

valorCambioReaisCentsinteger

Valor em centavos. Total da operação de câmbio convertido para reais. Obrigatório quando a modalidade é "cambio". Ex: R$ 5.000 → 500000.

Tipo de operação de câmbio, que define a alíquota de IOF aplicável: "compra_especie_viagem" — compra de moeda estrangeira em espécie para viagem (1,1%); "cartao_credito_exterior" — compra com cartão de crédito no exterior (3,38%); "cartao_debito_exterior" — compra com cartão de débito no exterior (1,1%); "remessa_exterior" — transferência para conta no exterior (0,38%); "recebimento_exterior" — recebimento de valores do exterior (0,38%); "educacao_saude" — pagamento de despesas de educação ou saúde no exterior (0%). Obrigatório quando a modalidade é "cambio".

valorCreditoCentsinteger

Valor em centavos. Valor total do empréstimo ou financiamento contratado. Obrigatório quando a modalidade é "credito". Ex: R$ 20.000 → 2000000.

prazoCreditoDiasinteger

Número de dias de vigência do contrato de crédito. Usado para calcular o IOF diário (0,0082% ao dia para pessoa física; 0,0041% ao dia para pessoa jurídica), limitado a 365 dias. Obrigatório quando a modalidade é "credito".

pessoaTipo'pf' | 'pj'

Tipo de pessoa do contratante: "pf" para pessoa física (IOF diário de 0,0082% ao dia no crédito); "pj" para pessoa jurídica (IOF diário de 0,0041% ao dia). Padrão: "pf".

currentDatestring date-time

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

Response

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.