---
title: "Calcula o novo preço médio de ações ou FIIs depois de uma compra: posição atual (quantidade + preço médio) mais a compra nova (quantidade + preço + custos). Pra várias compras, encadeie chamadas usando o resultado como posição seguinte. Venda não altera o preço médio."
method: GET
path: "/v1/calc/average-price"
tags: ["Calculadoras"]
---

# Calcula o novo preço médio de ações ou FIIs depois de uma compra: posição atual (quantidade + preço médio) mais a compra nova (quantidade + preço + custos). Pra várias compras, encadeie chamadas usando o resultado como posição seguinte. Venda não altera o preço médio.

`GET /v1/calc/average-price`

## Request

- Base URL: `https://api.falazuki.com`
- URL: `https://api.falazuki.com/v1/calc/average-price`
- Auth: none declared

Sem query params, devolve o schema de entrada em vez de calcular — útil pra descobrir o endpoint pelo navegador.

## Query parameters

- `current_quantity` number: Quantidade que já possui (0 se é a primeira compra)
- `current_average_price` number: Preço médio atual em R$ (0 se é a primeira compra)
- `buy_quantity` number, required: Quantidade comprada agora
- `buy_price` number, required: Preço pago por unidade em R$
- `fees` number: Corretagem e emolumentos da compra em R$ (entram no médio)

## Response `200`

Resultado do cálculo

- object: Campos variam por calculador. `currency` está sempre presente.
  - `currency` string

## Other responses

- `400`: Entrada inválida
- `503`: Taxas indisponíveis na fonte

---

[API](https://skmtc.dev/falazuki/apis/falazuki-finance-api.md) · [All operations](https://skmtc.dev/falazuki/apis/falazuki-finance-api/llms.txt) · [OpenAPI document](https://skmtc.dev/falazuki/apis/falazuki-finance-api/revisions/ad442f36c098?raw)