Custo médio por ação
100 ações compradas a 10 e 50 a 16 custam 1.800 por 150 ações, um custo médio de 12 por ação: o lote maior puxa a média para o seu preço. Informe cada compra e receba um único custo da posição. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
O custo médio por ação é o preço de compra ponderado de uma posição: cada lote contribui com o desembolso, e esse custo total é dividido pela quantidade de papéis que você realmente detém. Investidores, cadernos fiscais, rastreadores de DRIP e exercícios de sala de finanças precisam dessa cifra única para marcar uma venda posterior contra uma só base de custo em vez de uma lista desordenada de execuções. Esta calculadora de custo médio recebe uma lista de quantidades e preços de compra, multiplica cada lote, soma o caixa, soma as ações e devolve o preço médio ponderado. Uma média simples dos preços trataria um lote de dez papéis igual a um de mil; ponderar por ações não faz isso. Frações de ação são permitidas.
O que é o custo médio por ação e por que os pesos são as ações
O custo médio por ação de uma posição não é a média aritmética dos preços que você pagou. É uma média ponderada por papéis: cada compra contribui com caixa igual a ações vezes preço, esses desembolsos são somados e o total é dividido pela quantidade total de ações de todos os lotes.
Cem ações compradas a dez e cinquenta ações compradas a dezesseis custam mil mais oitocentos, ou seja mil e oitocentos de caixa para cento e cinquenta ações, então a média é doze, não a média simples de dez e dezesseis que seria treze. O lote maior puxa a média na direção do próprio preço, que é exatamente o que a tela de base de custo de uma corretora mostra ao informar o custo médio.
Frações de ação são de primeira classe: um plano de reinvestimento de dividendos que credita uma fração de papel a um preço impresso é um lote como qualquer outro, e entra nas somas a valor de face. Lotes de zero ações não contribuem para nenhuma das duas somas; são permitidos desde que outro lote forneça uma contagem estritamente positiva.
Quando todos os lotes têm zero ações não há denominador, e a calculadora recusa o pedido em vez de devolver Infinity ou um NaN que um formulário fiscal posterior trataria como número. Preços de compra negativos também são recusados. A calculadora não baixa uma cotação, não aplica ajustes de venda fictícia e não escolhe entre custo médio e identificação específica por você.
Só forma a média ponderada a partir dos lotes que você já tem.
Onde uma calculadora de custo médio por ação justifica o uso
Quem digita custo médio por ação numa busca já sabe que quer a base de custo de uma posição a partir dos lotes comprados, não uma cotação ao vivo, não uma beta contra o mercado e não uma ferramenta genérica de média ponderada estatística que pede valores e pesos abstratos.
Uma editora que ranqueia por essa consulta atende investidores de varejo que fizeram aportes periódicos no mesmo ticker ao longo de vários meses, cadernos de declaração que precisam imprimir um só custo médio por ação numa planilha de alienação, e engenheiros que precisam de um oráculo determinístico que recuse um total de ações nulo em vez de produzir Infinity em silêncio. Corretoras de DRIP e de frações creditam quantidades ímpares a preços impressos; esses lotes pertencem à mesma soma que as compras de papéis inteiros.
Como a implementação é código analítico parse de tier A, cada chamada bem-sucedida permanece barata sem tokens de modelo e sem rede de saída. A validação falha não consome saldo. Combine esta capacidade com uma ferramenta à parte de ganho ou perda quando vender depois; conserve esta superfície centrada no preço médio de compra que as pessoas querem dizer quando buscam custo médio por ação.
Casos de uso
Aportes periódicos no mesmo ticker
Informe cada compra como ações e preço de compra para publicar um só custo médio por ação em vez de média dos preços como se todo lote tivesse o mesmo tamanho.
Livros DRIP e de frações de ação
Inclua lotes de reinvestimento fracionário aos preços impressos para que a mesma identidade ponderada cubra compras de papéis inteiros e créditos drip.
Perguntas frequentes
Como se calcula o custo médio por ação?
Envie purchases como lotes de ações e preço de compra. O preço médio é a soma de ações vezes preço, dividida pela soma de ações. Exemplo: 100 ações a 10 e 50 a 16 produzem preço médio 12.
O que acontece se o número total de ações for zero?
O custo médio divide pelo total de ações, então um total de quantidade nulo ou vazio é recusado e não é cobrado.
Por que não simplesmente média dos preços de compra?
Uma média simples trata cada lote como igual. Um lote de cem ações a 10 deve pesar o dobro de um de cinquenta a 16; esta calculadora pondera por ações.
Posso informar frações de ação ou um único lote?
Sim. Frações de ação são permitidas, e um lote único devolve o preço de compra daquele lote como média. Ações negativas ou preços negativos são recusados.
A calculadora aplica regras de wash sale ou escolhe o método de custo por mim?
Não. Ela não faz ajustes de wash sale nem escolhe entre custo médio e identificação específica. Só calcula a média ponderada pelas ações dos lotes que você informar, sem buscar cotações.
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/fin/stock-average \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"purchases":[{"shares":100,"price":10},{"shares":50,"price":16}]}'const res = await fetch("https://api.kit.forhosting.com/fin/stock-average", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"purchases": [
{
"shares": 100,
"price": 10
},
{
"shares": 50,
"price": 16
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/fin/stock-average",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"purchases": [
{
"shares": 100,
"price": 10
},
{
"shares": 50,
"price": 16
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/stock-average", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"purchases":[{"shares":100,"price":10},{"shares":50,"price":16}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"purchases":[{"shares":100,"price":10},{"shares":50,"price":16}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/stock-average", 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
{
"purchases": [
{
"shares": 100,
"price": 10
},
{
"shares": 50,
"price": 16
}
]
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "fin.stock_average",
"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.
Limites
max_items | 10000 |
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
Se o total de ações for zero, a razão não está definida e a tarefa falha com invalid_input em vez de Infinity. Chamadas bem-sucedidas são cobradas a US$ 0,002; entrada inválida não é cobrada.
O que é o custo médio por ação e por que os pesos são as ações
Escreva essa identidade como average_price igual à soma de shares_i vezes price_i, dividida pela soma de shares_i. Contagens negativas não são uma venda neste modelo; tratar uma quantidade negativa como alienação misturaria em silêncio o emparelhamento FIFO com a contabilidade de custo médio, então são invalid_input.
Contrato de entrada, forma da resposta e validação
Cada objeto traz shares e price como números finitos. shares é a quantidade comprada naquele lote e deve ser maior ou igual a zero; frações de ação são permitidas. price é o preço de compra por ação em unidades monetárias e deve ser maior ou igual a zero. Um total de ações nulo faria o denominador zero, então é uma falha dura em vez de Infinity. Exemplo: cem ações a dez e cinquenta a dezesseis produzem total de ações cento e cinquenta, custo total mil e oitocentos e preço médio doze. Envie um corpo JSON com um único array obrigatório, purchases, de pelo menos um objeto. Os aliases lots, trades, buys, rows e fills são aceitos para que uma exportação da corretora não precise de um passo de renomear. No máximo dez mil lotes são lidos; cada valor de shares e de price deve permanecer dentro de um valor absoluto de um trilhão para que os produtos continuem duplos IEEE finitos no Worker e no navegador. purchases ausente, uma lista vazia, tokens não numéricos, NaN, Infinity, uma contagem negativa, um preço de compra negativo ou uma lista cujas quantidades somam zero falham com invalid_input nomeando o problema e não são cobrados. Em caso de sucesso o corpo devolve lot_count, total_shares, total_cost, average_price como o quociente, um array lots ecoado com shares, price e cost de cada lote, e uma string formula igual a average_price igual à soma de ações vezes preço sobre a soma de ações. Prefira números JSON a strings formatadas como moeda; marcas de câmbio e separadores de milhar não são analisados. O preço de um item bem-sucedido é um US$ 0,002 fixo.
Onde uma calculadora de custo médio por ação justifica o uso
Cursos de finanças pessoais em sala passam planilhas de base de custo e precisam de um oráculo que marque uma lista vazia ou de quantidade toda nula como invalid_input. Pipelines de automação chamam o mesmo contrato de API a US$ 0,002 por item bem-sucedido sem levantar um serviço de planilha. Mantenha as requisições pequenas, fixe average_price e total_cost arredondados nos testes, e você terá base de custo ponderada por ações reproduzível para widgets, cadernos e workers de borda sem montar um livro de carteira completo.
Casos de integração
Planilhas fiscais e de base de custo
Some os lotes em custo total e ações totais e fixe average_price numa planilha de alienação. Uma contagem total nula é recusada como invalid_input.
Perguntas técnicas
Quanto custa a calculadora de custo médio por ação?
A ferramenta do navegador é gratuita. Pedidos API usam saldo pré-pago KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.