Calculadora de ROI
Informe quanto investiu e quanto voltou: 1000 investidos e 1200 recebidos dão lucro líquido de 200,00 e ROI de 20,00 %. Os valores são tratados em centavos exatos, sem erros de arredondamento acumulados. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Valor investido
- 1000
- Valor retornado
- 1200
- Valor investido
- 1000.00
- Valor retornado
- 1200.00
- Lucro líquido
- 200.00
- Retorno sobre o investimento (%)
- 20.00
Informe o capital investido e o valor total recebido para obter o lucro líquido e o percentual de ROI, calculados em centavos inteiros exatos com arredondamento half-up, afastando-se de zero, para duas casas decimais.
O que o ROI mede
O retorno sobre o investimento compara o que um investimento devolveu com o que ele custou. Subtraia o capital investido do valor total recebido para obter o lucro líquido, divida esse lucro pelo capital investido e multiplique por 100. Investir 1000 e receber 1200 dá lucro líquido de 200,00 e ROI de 20,00 %. Um número positivo mostra que o dinheiro cresceu, um negativo que parte dele se perdeu, e não receber nada equivale a −100 %. Ver a porcentagem ao lado do lucro líquido ajuda a triar um negócio rapidamente.
Centavos exatos e arredondamento previsível
Os valores são convertidos em centavos inteiros antes de qualquer conta, então o dinheiro nunca acumula os pequenos erros das frações binárias: 1000 e 1200 viram 100000 e 120000 centavos. Depois a porcentagem é arredondada para duas casas, com a metade para cima e se afastando de zero, de modo que uma perda que cai exatamente na metade se afasta de zero em vez de se aproximar dele. Assim fica fácil conferir, linha por linha, uma coluna de ROI com duas casas na sua própria planilha.
Casos de uso
Triagem de negócios
Mostre o percentual de ROI e o lucro líquido ao lado de um simples desembolso de capital.
Validação de planilha
Verifique uma coluna de ROI de duas casas decimais, half-up, contra a sua própria planilha, no servidor.
Perguntas frequentes
Números de ponto flutuante são permitidos?
Não. Use um inteiro não negativo ou uma string de dinheiro com no máximo duas casas decimais.
Como o percentual é arredondado?
Half-up afastando-se de zero para duas casas decimais, calculado inteiramente em centavos inteiros.
E se eu recebi menos do que investi?
O lucro líquido e o ROI ficam negativos. Se nada voltar, ou seja, um retorno de zero, o ROI é de −100 %, o que significa que todo o investimento foi perdido.
O capital investido pode ser zero?
Não. O investimento precisa ser maior que zero, porque o ROI é dividido por ele. Já o valor recebido pode ser zero, para representar uma perda total.
Quantas casas decimais posso digitar?
Até duas, como em 1200,5 ou 1200,50. Sinal de mais na frente, zeros de preenchimento como em 01000, notação científica e mais de um separador decimal são recusados como formato inválido.
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
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/dev/roi \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"investment":"1000","return_amount":"1200"}'const res = await fetch("https://api.kit.forhosting.com/dev/roi", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"investment": "1000",
"return_amount": "1200"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev/roi",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"investment": "1000",
"return_amount": "1200"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/roi", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"investment":"1000","return_amount":"1200"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"investment":"1000","return_amount":"1200"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/roi", 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
{
"investment": "1000",
"return_amount": "1200"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev.roi",
"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
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
Fórmula e análise do dinheiro
dev.roi calcula o retorno sobre investimento como (return_amount − investment) ÷ investment × 100, junto com o net_profit que o impulsiona. Para evitar o desvio de ponto flutuante binário no dinheiro, ambas as entradas são convertidas em centavos inteiros com BigInt antes de qualquer aritmética: o exemplo 1000 e 1200 tornam-se 100000 e 120000 centavos, resultando em net_profit 200,00 e roi_percent 20,00. Cada campo aceita ou um inteiro seguro não negativo ou uma string decimal canônica com no máximo duas casas fracionárias — "1200", "1200.5" e "1200.50" são todos válidos, mas um sinal de mais à frente, zeros de preenchimento como "01000", notação científica, mais de um ponto decimal ou um literal float de JavaScript são todos rejeitados como formato inválido. investment deve ser convertido para mais de zero centavos para que a divisão seja definida; return_amount pode ser zero, o que representa uma perda total e produz um −100,00 por cento.
Centavos inteiros e half-up afastando-se de zero
Os dois centésimos que restam tornam-se as duas casas decimais da string do percentual. roi_percent nunca é calculado em ponto flutuante. Trabalhando inteiramente em BigInt, o motor forma profit_cents × 10000, depois divide por investment_cents com um passo explícito half-up, afastando-se de zero — ele soma metade do divisor antes da divisão inteira e espelha o sinal para perdas, de modo que um valor exatamente em −0,5 arredonda para −1 em vez de em direção a zero. Quando return_amount é menor que investment, tanto net_profit quanto roi_percent carregam um sinal de menos à frente: invista 1000, receba de volta 800, e você vê net_profit −200,00 com roi_percent −20,00.
Saídas, erros e onde executar
O design permanece deliberadamente restrito — a versão um não anualiza, não pondera uma carteira nem converte moedas — de modo que a superfície assinada é curta e auditável. Tarefas com falha nunca são cobradas do saldo pré-pago. Toda resposta bem-sucedida devolve quatro strings de duas casas decimais: investment e return_amount normalizados à forma canônica, net_profit com seu sinal, e roi_percent. Os caminhos de erro usam mensagens estáveis e correspondíveis, cada uma lançada como um invalid_input tipado: um investment ou return_amount ausente, um investment zero, um valor negativo sinalizado como negativo à frente do nome do campo, e dinheiro malformado reportado como formato inválido.
Casos de integração
Testes golden de CI
Fixe strings exatas de net_profit e roi_percent que nunca sofrem desvio entre plataformas.
Perguntas técnicas
investment pode ser zero?
Não. Deve ser convertido para mais de zero centavos, caso contrário você recebe um erro tipado invalid_input.
O ROI pode ser negativo?
Sim, quando return_amount é menor que investment; tanto net_profit quanto o percentual carregam um menos.
É grátis no navegador?
Sim. A API custa US$ 0,002 por chamada, cobrada apenas em tarefas bem-sucedidas.