Pular para o conteúdo principal

Changelog

Esta página documenta todas as alterações relevantes da plataforma e da API da Blocklens.

2026-10-22​

Mapa de liquidações (novo dashboard, Lab → Dashboards → Blocklens Special)

  • Mostra em quais preços as posições alavancadas abertas seriam encerradas à força: Hyperliquid — posições reais (cada posição aberta com seu preço de liquidação, varredura diária) e Binance — modelo (níveis estimados a partir do open interest e da alavancagem típica) — lado a lado ou uma de cada vez, para BTC, ETH, SOL e HYPE.
  • Heatmap ao longo do tempo (o mapa de cada dia com a linha de preço; zoom, clique num dia para abrir o seu mapa) e o mapa atual (volume de liquidações por faixa de preço com curvas acumuladas, principais clusters e cobertura).
  • Opção Sem as 20 maiores posições para Hyperliquid; dias com janela parcial do modelo da Binance e dias reconstruídos entre snapshots de arquivo são marcados como estimativa.
  • Exportação PNG para todos, CSV/JSON no Pro; favoritos e links compartilháveis.
  • Planos: Free — os últimos 30 dias e o mapa atual; Pro — o histórico completo.

Gráficos

  • Charts → Futures → Liquidation maps: os heatmaps e os mapas atuais das duas fontes como gráficos separados.

API & MCP

  • Novos endpoints de mapas de liquidações (Liquidation Map API) e ferramentas MCP get_liquidation_map e get_liquidation_heatmap, com os mesmos limites de plano.

Como os mapas são construídos e o que podem e não podem dizer: metodologia do mapa de liquidações. O mapa é uma ferramenta descritiva, não um alvo de preço nem um sinal de trading.

2026-10-19​

Cohort Spending Analysis (dashboard Enterprise)

  • Correção de dados: em intervalos com mais de dois anos, a semana ou o mês em cada limite interno de carregamento era contado duas vezes (ex.: a semana de 2019-12-30 exibia ₿2.3M em vez de ₿1.14M), e o SOPR anual era aproximado (o LTH SOPR de 2018 exibia 1.10 em vez de 1.33). Ambos agora correspondem exatamente aos dados de origem. As datas não se deslocam mais um dia para usuários a leste do UTC.
  • Primeiros/últimos períodos incompletos são marcados como parciais; as coortes padrão agora começam com 1d (idade de exatamente 1 dia) e 1d–1w (2–6 dias).
  • Carregamento mais rápido para intervalos longos, alternância instantânea entre BTC/USD, e o estado do dashboard (intervalo, agregação, unidade, aba, datas, coortes personalizadas) é mantido em um link compartilhável.
  • Market X-Ray abre com uma comparação padrão (último período vs ~1M/3M/6M/1Y antes), os períodos são escolhidos por ano e as colunas são rotuladas por coorte.
  • Cohort Breakdown adiciona uma visualização % do volume, uma sobreposição de SOPR por coorte e a parcela gasta com prejuízo; SOPR Pulse usa escala logarítmica por padrão.
  • O editor de coortes valida nomes e intervalos antes de aplicar; datas e números seguem o seu idioma; as exportações (PNG/CSV/JSON) contêm exatamente o que a aba ativa mostra.

API

  • POST /v1/enterprise/sopr: buckets e coortes agora também retornam btc_volume, usd_volume e cost_basis_usd; cada período retorna first_date, last_date e days. Os nomes de coortes podem usar qualquer sistema de escrita; nomes duplicados e faixas de idade sobrepostas são rejeitados com 422.

2026-10-18​

Correção de dados

  • Net Liquidity (macro_net_liquidity): o componente Reverse Repo era subtraído sem conversão de unidades, o que superestimava o nível em até ~$2T em 2021–2023 (ex.: 2022-06-01: $6.16T, antes exibido como $8.12T). Todo o histórico foi recalculado. A série agora é publicada para cada dia útil dos EUA, em vez de semanalmente.
  • Bitcoin treasuries (/v1/dat/*): as posições de parte das empresas e governos acompanhados ficaram travadas nos valores de 2026-08-10. O histórico de 2026-08-11 → 2026-10-16 foi corrigido e os agregados recalculados.
  • Totais de ETF (/v1/etf/aggregate): o Grayscale Mini era contado duas vezes em 2024-07-31 → 2026-07-18, superestimando as posições totais dos ETFs em até ~48 mil BTC (ex.: 2025-06-02: 1.301.052 BTC, antes 1.344.415). Posições totais, AUM, dominância de BTC, número de ETFs, participações de mercado e o preço realizado dos ETFs foram recalculados.
  • WisdomTree Bitcoin Fund (BTCW) agora é contado como ETF spot dos EUA: us_btc_holdings, us_aum e o preço realizado dos ETFs spot dos EUA o incluem desde 2024-01-11.
  • As descrições de etf_realized_price e us_spot_etf_realized_price agora refletem o cálculo real (soma do custo médio ponderado por fundo / BTC em carteira); os valores não mudaram.

Fluxos de ETF

  • Os fluxos diários agora estão alinhados à data de negociação para todos os fundos.
  • Novos campos: flow_usd (/v1/etf/ticker) e us_spot_net_flow_usd (/v1/etf/aggregate) — fluxo líquido diário em USD.
  • Fluxos históricos de FBTC e IBIT corrigidos e dias ausentes preenchidos (ex.: ARKB 2026-09-21).
  • Adicionado MSBT (Morgan Stanley Bitcoin Trust).
  • flow_usd e us_spot_net_flow_usd agora cobrem todo o histórico desde 2024-01-11; o dia mais recente é provisório até que todos os fundos publiquem seus números.
  • Fluxos acumulados em USD recalculados a partir do fluxo diário exato em USD: us_spot_cumulative_money_flow agora é a soma de us_spot_net_flow_usd desde 2024-01-11 ($56,9 bi em 2026-10-16; antes estimado em $83,3 bi). etf_cumulative_money_flow usa o fluxo exato para os ETFs spot dos EUA; ETPs fora dos EUA e o GBTC antes de 2024 continuam sendo uma estimativa (variação de BTC × preço do BTC).
  • Os gráficos ETF Net Flow e ETF Net Flow Comparison agora mostram o fluxo em USD ao lado do fluxo em BTC.

Derivativos

  • A BitMEX foi removida de open interest e funding após o encerramento da exchange (os dados até 2026-09-16 foram mantidos).
  • Adicionados os funding rates da Kraken e da Bitfinex.

2026-09-04​

Correção de dados

  • Os preços diários históricos do BTC (OHLC) de 2026-04-17 → 2026-07-11 foram corrigidos para coincidir com a nossa fonte de referência. As séries derivadas do preço — realized volatility (1w–1y) e price drawdown — foram recalculadas para o intervalo afetado.
  • Realized Cap by Age (<24h) e a divisão Realized Cap by Age (%) de 2026-07-06 e 2026-07-07 foram recalculados (antes estavam subestimados).
  • Nenhuma outra métrica foi afetada: realized cap, MVRV, NUPL e as séries de holders permanecem inalteradas.

2026-05-17​

Snapshot API

  • O SVG agora é um formato de primeira classe, em pé de igualdade com o PNG. O campo format de POST /v1/chart/snapshot aceita "png", "svg" ou "json"; tanto GET quanto POST também respeitam o cabeçalho Accept: image/svg+xml.
  • Nova rota: GET /v1/chart/renders/{render_id}.svg — os SVGs renderizados são persistidos por 1 hora e podem ser recuperados novamente por URL, espelhando o comportamento já existente do .png.
  • As respostas em SVG agora incluem X-Render-Id, para que a URL persistente possa ser reconstruída a partir de uma única chamada de renderização.
  • As variantes PNG e SVG do mesmo gráfico são armazenadas em cache de forma independente.
  • As sobreposições de desempenho de ciclo (x_axis: "day_offset") agora renderizam os rótulos das marcas do eixo X como datas de calendário do ciclo mais recente da família escolhida (por exemplo, Oct '25, Jan '26, … para sobreposições de ATH ancoradas em cycle_ath_5 → 2025-10-06) em vez de Day 0, Day 90, …. Os ciclos anteriores permanecem alinhados nas mesmas posições do eixo.

MCP Server

  • render_chart: o enum do parâmetro format agora é "png" | "svg" | "json" (era "png" | "json"). Quando format: "svg" é passado, a ferramenta retorna um bloco de conteúdo image/svg+xml e uma URL /chart/renders/{id}.svg no resumo.

2026-04-02​

Metrics & API

  • A contagem de métricas foi expandida de 127 para mais de 210 métricas ativas (exchanges, derivativos, DAT e outras).
  • Novo endpoint: GET /v1/cycle-boundaries — datas de início/fim e durações dos ciclos de halving do Bitcoin.
  • A Metrics API agora usa um construtor de consultas orientado por registro para uma formatação de resposta consistente.

Snapshot API

  • Renderização de heatmap: renderize gráficos baseados em distribuição (por exemplo, Distribuição de Base de Custo) com escalas de cor configuráveis (viridis, plasma, etc.) e escalas no eixo Y. Inclui legenda da escala de cor.
  • Gráficos de sobreposição de desempenho de ciclo: x_axis: "day_offset" alinha todos os ciclos de halving no Day 0 para comparação.
  • Novo parâmetro por métrica: show_in_legend — controla se métricas individuais aparecem na legenda do gráfico.

MCP Server

  • Nova ferramenta: get_cycle_boundaries — consulte as datas dos ciclos de halving diretamente a partir de agentes de IA.
  • render_chart agora suporta renderização de heatmap e sobreposições de desempenho de ciclo.
  • Base de código TypeScript unificada (tools.ts) para todas as ferramentas MCP.
  • Contagem de ferramentas: 18 → 19.

2025-09-25​

  • Configuração inicial do site de documentação docs.blocklens.co.