Como Construímos as Calculadoras

1. Abordagem principal

• Definir fórmula por tipo de problema (lucro, ROI, liquidação etc.).
• Normalizar entradas para unidades consistentes.
• Calcular no cliente em tempo real.
• Exibir suposições-chave junto ao resultado.

2. Fontes e cache

Entram nestas calculadoras dois tipos de números, e cada um é mantido de forma completamente diferente.

Dados de mercado em tempo real: os preços vêm sobretudo da API da CoinGecko e os rendimentos de mineração são cruzados com a WhatToMine. O cliente usa cache e deduplicação; estes valores nunca são editados à mão.

• Documentação da API CoinGecko

3. Constantes regulatórias e de protocolo

Taxas de imposto, limites de detenção, isenções sucessórias e factos de protocolo não podem vir de uma API de preços — vêm da lei e das regras de consenso. O CryptoCalk acompanha 101 constantes deste tipo (79 regulatórias em 17 jurisdições, mais valores de protocolo e de fórmula) num registo versionado, cada uma com a fonte primária contra a qual foi verificada e a data dessa verificação.

Lemos a fonte primária, não um resumo dela.

• A taxa de 28% e a exclusão aos 365 dias em Portugal são lidas no próprio Código do IRS consolidado (art. 72.º n.º 1 al. c) e art. 10.º n.º 22) — e não num blogue de guias fiscais.
• Os escalões australianos vêm das tabelas da ATO; os valores alemães de rendimento e sucessões dos textos legais do EStG §32a e do ErbStG §16/§19.
• A inclusão de 50% das mais-valias no Canadá é retirada do Income Tax Act s.38; os escalões sucessórios e as regras de declaração do Japão vêm da NTA; os 15–22,5% progressivos do Brasil, da Lei 8.981.
• Os factos de protocolo são lidos no protocolo: o limite de poeira de 546 satoshis vem do ficheiro policy.cpp do Bitcoin Core e as recompensas por bloco são reconciliadas com as saídas coinbase on-chain.

4. Como essas constantes são mantidas atuais

Um monitor automático relê cada página de origem de forma programada e assinala as que mudaram. Um alerta nunca é aplicado às cegas: cada valor assinalado é reverificado à mão contra a fonte primária antes de qualquer número mudar. Mudanças ditadas pelo calendário — um halving, uma era de emissão, um ano fiscal que começa a 1 de julho — são seguidas por datas, porque nenhum vigia de página consegue vê-las antes de acontecerem.

Toda alteração que chega ao site fica datada no registo e é publicada no changelog. As verificações que não encontram nada de errado também são registadas, para que «verificado e inalterado» se distinga de «nunca verificado».

Este processo existe porque já encontrámos erros reais nos nossos próprios números e preferimos registá-los a corrigi-los em silêncio: uma recompensa de mineração da Dash que exagerava a receita do mineiro em quatro vezes, uma estimativa de imposto sucessório japonês cerca de três vezes alta demais e uma recompensa por bloco da Kaspa dez vezes abaixo do valor real.

5. Famílias de fórmulas

Cobertura principal: Lucro/ROI, DCA/histórico e ferramentas de risco/margem.

Exemplos: Lucro, ROI, DCA, E Se, Tamanho da Posição e Liquidação.

6. Limitações conhecidas e uso responsável

A execução real pode divergir por spread, slippage, taxas e timing de mercado.

• Sucessões — moeda: a calculadora de imposto sucessório pede o valor da carteira em USD, mas aplica os limiares de cada país na moeda desse país (iene, euro, libra). Para uma comparação aproximada chega; para uma herança real perto de um limiar, converta primeiro para a moeda local.
• Sucessões — Japão: assume-se que os herdeiros recebem quotas legais iguais e o crédito fiscal do cônjuge (配偶者の税額軽減) não é modelado; ambos podem reduzir bastante uma obrigação real.
• Alterações anunciadas mas ainda não em vigor não são aplicadas antecipadamente. Quando há data de início conhecida (por exemplo, um escalão australiano que desce a 1 de julho de 2027), usa-se o valor do ano corrente até essa data chegar.
• O tratamento fiscal varia com a jurisdição e a estrutura da conta.

• Política editorial: padrão de fontes e correções