Metodologia de Cálculo de Preços

1. Fontes de Dados

2.1 Integração de exchanges

O CoinPaprika se integra com exchanges de criptomoedas por meio de suas APIs públicas. Cada exchange deve fornecer identificadores de pares de mercado (p. ex., BTC/USD, ETH/BTC), o último preço negociado para cada par de mercado e o volume de negociação de 24 horas para cada par de mercado.

2.2 Escopo

Apenas os mercados spot são incluídos no pipeline de cálculo de preços. Os mercados de derivativos (futuros, swaps perpétuos, opções) são excluídos, pois seus preços podem divergir significativamente do preço spot subjacente devido a taxas de financiamento, mecânicas de vencimento e dinâmicas de alavancagem.

2.3 Dados de referência externos

As taxas de câmbio de moedas fiat são obtidas do Open Exchange Rates para conversão entre moedas fiat (EUR, GBP, JPY, etc.) e USD. As taxas de paridade de stablecoins — USDT, USDC e outras stablecoins principais — são convertidas para USD usando um índice ponderado por volume derivado de seus mercados de entrada em USD.

2. Pipeline de Cálculo de Preços

O algoritmo foi projetado para calcular preços com base exclusivamente no estado atual do mercado, sem dependência de preços de execuções anteriores do algoritmo. Cada execução começa do zero, inicializando suas próprias taxas de conversão a partir de dados de mercado em tempo real e convergindo para preços precisos por meio de múltiplas iterações. Todo o pipeline é executado a cada 60 segundos.

1. Coleta de dados

   De cada exchange integrado, o CoinPaprika busca todos os mercados spot disponíveis. Cada mercado fornece: nome do par de mercado (p. ex., BTC/USD), último preço negociado na moeda de cotação e volume de negociação de 24 horas na moeda de cotação.

2. Estabelecer a taxa de referência BTC/USD

   O algoritmo começa com preços assumidos em zero. O primeiro cálculo é o preço médio ponderado de BTC/USD, derivado diretamente de todos os mercados spot BTC/USD. O Bitcoin é escolhido porque os mercados de BTC são tipicamente os mais líquidos em todos os exchanges.

   BTC_USD = Σ(Price_i × Volume_i) / Σ(Volume_i)
   where i = each BTC/USD market across all exchanges

3. Primeira passagem: Apenas mercados BTC e fiat

   Usando a taxa BTC/USD, o algoritmo processa mercados onde um lado do par é BTC ou uma moeda fiat. Mercados denominados em BTC (p. ex., ETH/BTC, SOL/BTC):

   Price_USD = Price_BTC × BTC_USD

   Mercados denominados em fiat (p. ex., ETH/EUR, BTC/JPY):

   Price_BTC = Price_USD / BTC_USD

4. Passagens subsequentes: Incorporar todos os mercados

   Muitas criptomoedas também são negociadas contra outras criptomoedas. O algoritmo usa as taxas de conversão da passagem anterior para resolver esses mercados iterativamente.

   Pass 1: BTC/USD markets → BTC_USD rate
   Pass 2: BTC + fiat markets → conversion rates for major coins
   Pass 3: All markets using Pass 2 rates → refined rates, more coins covered
   Pass N: Repeat until convergence → all reachable coins have prices

5. Detecção e remoção de outliers

   Antes da agregação final, preços de mercado anômalos são identificados e excluídos. Os mercados excluídos de antemão incluem aqueles com taxas de negociação zero, incentivos de mineração por transação, dados obsoletos (>30 min) e pares na lista negra. A detecção estatística de outliers usa limites baseados na mediana ajustados para a profundidade de liquidez.

6. Preço final: Média ponderada por volume

   Após a remoção de outliers, o preço final é a média ponderada por volume de todos os mercados válidos restantes:

   Price_USD = Σ(Price_i_USD × Volume_i_USD) / Σ(Volume_i_USD)

   Mercados com maior liquidez naturalmente carregam mais peso, garantindo que o preço agregado reflita onde ocorre a maior parte da atividade de negociação real.

3. Cálculo do Volume de Negociação

4.1 Volume por exchange

O volume de negociação de 24 horas para cada exchange é a soma dos volumes convertidos em USD de todos os seus pares de negociação ativos e não incluídos na lista negra. Pares que não foram atualizados em 30 minutos são excluídos.

Exchange_Volume = Σ(Volume_pair_i × Price_pair_i_USD)

4.2 Volume por ativo

O volume de negociação de 24 horas para um ativo individual é a soma dos volumes de todos os seus pares de mercado válidos em todos os exchanges integrados.

4.3 Volume global

O volume global de negociação de criptomoedas é a soma de todos os volumes por exchange.

4. Pontuação de Confiança do Exchange

Cada exchange recebe uma Pontuação de Confiança em uma escala de 0–100 que reflete a confiabilidade e a qualidade dos dados reportados. A Pontuação de Confiança influencia como os dados do exchange são ponderados e filtrados no pipeline de cálculo de preços.

5.1 Critérios de avaliação

5.2 Aplicação da Pontuação de Confiança

• Exchanges sob revisão são excluídos completamente dos cálculos de preço e volume.
• As Pontuações de Confiança são revisadas e atualizadas periodicamente e podem mudar imediatamente em resposta a eventos significativos (ataques, ações regulatórias, interrupções prolongadas de API, etc.).
• Os dados do exchange estão sujeitos a escrutínio adicional por meio do Indicador de Liquidez de Pares de Mercado (consulte a Seção 5).

5.3 Volume Real Estimado (ERV)

O Volume Real Estimado é uma medida introduzida em 2019 para combater volume falso e wash trading. ERV é derivado dos Indicadores de Liquidez de todos os mercados de um determinado exchange. O volume reportado de 24 horas de cada mercado é ajustado usando pesos atribuídos à sua categoria de indicador de liquidez (Bom, Médio ou Ruim).

5. Indicador de Liquidez de Pares de Mercado (Pontos)

Os pares de mercado individuais recebem uma avaliação de liquidez em tempo real baseada no spread do livro de ordens (diferença percentual entre o melhor lance de compra e venda), profundidade do livro de ordens (valor dentro de ±1% e ±10% do preço médio), consistência do volume e verificações de outliers.

6.1 Categorias do indicador

• Bom — Forte liquidez e condições normais de mercado.
• Médio — Condições de mercado restritas ou flutuantes; a liquidez é menor do que o volume reportado sugere.
• Ruim — Liquidez inadequada em relação ao volume reportado, ou condições de mercado gravemente desequilibradas.

Pares de mercado que não passam nas verificações de liquidez têm peso reduzido no cálculo VWAP. Se não houver outra fonte para calcular o preço e o volume de um ativo, o par ainda é utilizado — com uma indicação clara de que a liquidez não pôde ser verificada.

6. Fornecimento Circulante

7.1 Moedas Proof-of-Work

Para criptomoedas baseadas em PoW (p. ex., Bitcoin, Litecoin), o fornecimento circulante é consultado diretamente de APIs de exploradores de blocos. Os valores são verificados em múltiplos exploradores de blocos independentes e atualizados automaticamente à medida que novos blocos são minerados.

7.2 Tokens (baseados em contratos inteligentes)

Para tokens ERC-20 e similares, o fornecimento circulante é calculado como:

Circulating Supply = Total Supply - Locked Tokens

Locked Tokens includes:
  - Team/founder vesting wallets
  - Treasury or reserve wallets
  - Burn addresses
  - Locked staking contracts

7.3 Verificação

Os números de fornecimento circulante são cruzados com dados divulgados pelas equipes dos projetos e atualizados quando ocorrem eventos de desbloqueio, queimas de tokens ou outros eventos que afetam o fornecimento. Limites específicos são intencionalmente omitidos para evitar manipulações.

7. Métricas Derivadas

8.1 Capitalização de Mercado

Per-asset:  Market Cap = Current Price (USD) × Circulating Supply
Global:     Global Market Cap = Σ(Market Cap of all tracked assets)

8.2 Máxima Histórica (ATH)

Para cada ativo, o CoinPaprika rastreia o maior preço agregado já registrado, a data em que ocorreu e a distância atual do ATH:

ATH Distance (%) = (ATH Price − Current Price) / ATH Price × 100%

8. Critérios de Listagem

9.1 Ativos de Criptomoedas

Para ser listada no CoinPaprika, uma criptomoeda deve atender aos seguintes requisitos:

• Um site funcional de propriedade do projeto com informações claras sobre o projeto
• Um explorador de blocos funcional com dados on-chain verificáveis
• Negociação ativa em pelo menos um exchange integrado ao CoinPaprika
• Comunicação transparente — o projeto mantém canais públicos (X/Twitter, Telegram, Discord) com atualizações oportunas e capacidade de resposta a problemas da comunidade

9.2 Exchanges

Para ser integrado como fonte de dados, um exchange deve:

• Operar um site funcional com atividade de negociação verificável
• Fornecer uma REST API pública que atenda aos padrões de dados do CoinPaprika (pares de mercado, preços, volumes)
• Manter documentação de API atualizada
• Fornecer um ponto de contato dedicado para problemas de qualidade de dados

9. Frequência de Atualização