ForHosting KIT · Finanças e dinheiro

Estimador de imposto sobre ganho de capital

Vender por 50.000 algo que custou 30.000, após 400 dias, gera um ganho de longo prazo de 20.000 e, a 15%, um imposto de 3.000. Informe venda, custo e dias para ver o prazo, a alíquota e o imposto. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Receita da venda: 50.000
Base de custo: 30.000

Você obtém

Ganho de capital: 20.000
Prazo de posse: long
Alíquota de imposto (%): 15
Imposto sobre ganho de capital: 3.000

Esta calculadora recebe o produto da venda, o custo de aquisição e o número de dias em que um ativo ficou em posse e, então, retorna o ganho de capital, se o ganho é de curto ou longo prazo, a alíquota aplicada incluindo qualquer sobretaxa NIIT e o imposto devido resultante.

Como o ganho, o prazo e a alíquota se combinam

O ganho de capital é o que você recebe numa venda menos o que o bem custou. A calculadora encontra primeiro esse ganho e depois olha por quanto tempo você manteve o bem. Se os dias de posse passam do limite, 365 por padrão, o ganho é de longo prazo e vale a alíquota de longo prazo, 15% se você não mudar; caso contrário, é de curto prazo e vale a alíquota de curto prazo, 37% por padrão. A sobretaxa que você informar é somada por cima. Vender por 50.000 um bem que custou 30.000 depois de 400 dias gera 20.000 de ganho tributados a 15%: 3.000 de imposto.

Erros que mudam a conta

Vender um dia antes pode levar o ganho para a alíquota de curto prazo, então confira os dias antes de vender: com o limite padrão, exatamente 365 dias ainda contam como curto prazo. Uma venda com prejuízo resulta em imposto zero, nunca em um valor negativo. As alíquotas padrão são um ponto de partida, não o seu ano fiscal: troque-as pelas que valem para você. O imposto é calculado sobre o ganho sem arredondamento, então o arredondamento da tela não altera o valor devido. É uma estimativa, não consultoria fiscal.

Casos de uso

Estimativa fiscal pré-venda

Antes de vender ações, cripto ou imóveis, estime o ganho e o imposto devido e veja como cruzar o limiar de posse de longo prazo muda a alíquota e o valor a pagar.

Integração com consultores e ferramentas

Incorpore uma estimativa determinística de ganho de capital em uma ferramenta de planejamento ou memorando ao cliente, substituindo as premissas de alíquota para corresponder a um ano fiscal específico.

Perguntas frequentes

Quais alíquotas ela usa por padrão?

Ela assume por padrão uma alíquota de curto prazo de 37%, uma de longo prazo de 15% e uma sobretaxa NIIT de 0%.

O que acontece se eu vender com prejuízo?

O imposto é limitado a zero, então um ganho negativo informa a perda real no campo gain, mas um imposto de 0. O prazo e a alíquota ainda são retornados.

Isto é consultoria fiscal?

Não. É uma estimativa determinística que você controla totalmente pelas entradas de alíquota.

Quando um ganho conta como de longo prazo?

Quando você manteve o bem por mais dias que o limite, que é de 365 se você não mudar. Com exatamente 365 dias ainda é curto prazo; com 400 dias já é longo prazo.

Posso somar a sobretaxa sobre a renda líquida de investimentos?

Sim. Informe a alíquota da sobretaxa e ela é somada à alíquota de curto ou de longo prazo antes do cálculo do imposto. Se você não informar nada, ela fica em zero.

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/finance/capital-gains-tax

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/finance/capital-gains-tax \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"proceeds":50000,"cost_basis":30000}'

const res = await fetch("https://api.kit.forhosting.com/finance/capital-gains-tax", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "proceeds": 50000,
    "cost_basis": 30000
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/finance/capital-gains-tax",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "proceeds": 50000,
    "cost_basis": 30000
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/finance/capital-gains-tax", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"proceeds":50000,"cost_basis":30000}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"proceeds":50000,"cost_basis":30000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/finance/capital-gains-tax", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "proceeds": 50000,
  "cost_basis": 30000
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "finance.capital_gains_tax",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Notas técnicas

Como o ganho, o prazo e o imposto são calculados

O imposto é então Math.max(0, gain) multiplicado por esse percentual de alíquota combinada, de modo que uma perda produz imposto zero em vez de um número negativo. Exemplo prático: produto de 50.000, custo de aquisição de 30.000, mantido por 400 dias a uma alíquota de longo prazo de 15% dá um ganho de 20.000, prazo 'long', alíquota 15% e imposto de 3.000. A ferramenta calcula primeiro o ganho como proceeds menos cost_basis. Em seguida, classifica o período de posse: se holding_days for estritamente maior que long_threshold_days (padrão 365), o ganho é de longo prazo; caso contrário, é de curto prazo. A alíquota aplicável é a de longo prazo (lt_rate, padrão 15%) ou a de curto prazo (st_rate, padrão 37%) mais qualquer sobretaxa de imposto sobre renda líquida de investimentos (niit_rate, padrão 0%). A saída retorna proceeds, cost_basis, holding_days, o gain arredondado, a string do prazo, rate_percent e o imposto arredondado.

Entradas, padrões, arredondamento e validação

Um campo decimals (padrão 2) arredonda o ganho e o imposto usando uma regra half-up explícita aplicada uma vez por saída. Observe que o imposto é calculado a partir do ganho bruto, não do ganho arredondado, então o arredondamento de exibição nunca distorce o valor devido. Somente proceeds e cost_basis são obrigatórios; ambos precisam ser números finitos e qualquer um deles pode ser negativo se você estiver modelando uma posição incomum. holding_days assume 400 por padrão e precisa ser um inteiro não negativo — uma contagem de dias fracionária ou negativa retorna um erro tipado invalid_input. As premissas de alíquota são todas substituíveis: st_rate, lt_rate, niit_rate e long_threshold_days permitem que você corresponda a uma jurisdição ou ano fiscal específico sem fixar as faixas dos EUA no código. Como a perda é limitada a imposto zero, o prazo e o rate_percent ainda são informados mesmo quando nenhum imposto é devido.

Widget, API e páginas multilíngues

Esta é uma estimativa determinística, não uma consultoria fiscal. Recorra à API quando precisar precificar muitos lotes de uma vez, embasar uma varredura de colheita de perdas fiscais em carteira ou substituir as premissas de alíquota por jurisdição em milhares de linhas. As execuções de API são cobradas a partir de US$ 0,002 contra o saldo pré-pago do KIT, e apenas tarefas bem-sucedidas são cobradas. As páginas são publicadas em oito idiomas com slugs e palavras-chave traduzidos, para que alguém pesquisando uma estimativa de ganho de capital no próprio idioma chegue a uma página local, enquanto os nomes dos campos JSON permanecem idênticos em cada localidade.

Casos de integração

Varreduras de carteira e colheita

Chame a API em muitos lotes com alíquotas personalizadas de curto prazo, longo prazo e NIIT para modelar a colheita de perdas fiscais ou comparar jurisdições em massa.

Perguntas técnicas

Como se decide entre curto e longo prazo?

Um ganho é de longo prazo quando holding_days é estritamente maior que long_threshold_days (padrão 365); caso contrário, é de curto prazo. O limiar é configurável.

Quais entradas são obrigatórias e validadas?

proceeds e cost_basis são números finitos obrigatórios; holding_days precisa ser um inteiro não negativo. Qualquer outra coisa retorna um erro tipado invalid_input.

Ver a documentação completa do KIT →

Executar grátis