Passa al contenuto principale

Changelog

Questa pagina documenta tutte le modifiche rilevanti alla piattaforma e all'API di Blocklens.

2026-10-22​

Mappa delle liquidazioni (nuovo dashboard, Lab → Dashboards → Blocklens Special)

  • Mostra a quali prezzi le posizioni aperte con leva verrebbero chiuse forzatamente: Hyperliquid — posizioni reali (ogni posizione aperta con il suo prezzo di liquidazione, scansione giornaliera) e Binance — modello (livelli stimati dall'open interest e dalla leva tipica) — affiancate o una alla volta, per BTC, ETH, SOL e HYPE.
  • Heatmap nel tempo (la mappa di ogni giorno con la linea del prezzo; zoom, clic su un giorno per aprirne la mappa) e la mappa attuale (volume delle liquidazioni per fascia di prezzo con curve cumulative, cluster principali e copertura).
  • Interruttore Senza le 20 posizioni più grandi per Hyperliquid; i giorni con una finestra parziale del modello Binance e i giorni ricostruiti tra snapshot d'archivio sono contrassegnati come stime.
  • Esportazione PNG per tutti, CSV/JSON con Pro; preferiti e link condivisibili.
  • Piani: Free — gli ultimi 30 giorni e la mappa attuale; Pro — lo storico completo.

Grafici

  • Charts → Futures → Liquidation maps: le heatmap e le mappe attuali di entrambe le fonti come grafici separati.

API & MCP

  • Nuovi endpoint per le mappe delle liquidazioni (Liquidation Map API) e strumenti MCP get_liquidation_map e get_liquidation_heatmap, con gli stessi limiti di piano.

Come vengono costruite le mappe e cosa possono e non possono dire: metodologia della mappa delle liquidazioni. La mappa è uno strumento descrittivo, non un obiettivo di prezzo né un segnale di trading.

2026-10-19​

Cohort Spending Analysis (dashboard Enterprise)

  • Correzione dei dati: per intervalli superiori a due anni, la settimana o il mese a ogni confine interno di caricamento veniva contato due volte (ad es. la settimana del 2019-12-30 mostrava ₿2.3M invece di ₿1.14M), e lo SOPR annuale era approssimato (l'LTH SOPR per il 2018 mostrava 1.10 invece di 1.33). Entrambi ora corrispondono esattamente ai dati di origine. Le date non si spostano più di un giorno per gli utenti a est di UTC.
  • I primi/ultimi periodi incompleti sono contrassegnati come parziali; le coorti predefinite ora iniziano con 1d (età di esattamente 1 giorno) e 1d–1w (2–6 giorni).
  • Caricamento più rapido per intervalli lunghi, passaggio istantaneo tra BTC/USD, e lo stato del dashboard (intervallo, aggregazione, unità, scheda, date, coorti personalizzate) viene mantenuto in un link condivisibile.
  • Market X-Ray si apre con un confronto predefinito (ultimo periodo vs ~1M/3M/6M/1Y prima), i periodi si scelgono per anno e le colonne sono etichettate per coorte.
  • Cohort Breakdown aggiunge una vista % del volume, una sovrapposizione dello SOPR per coorte e la quota spesa in perdita; SOPR Pulse usa per impostazione predefinita una scala logaritmica.
  • L'editor delle coorti convalida nomi e intervalli prima di applicarli; date e numeri seguono la tua lingua; le esportazioni (PNG/CSV/JSON) contengono esattamente ciò che mostra la scheda attiva.

API

  • POST /v1/enterprise/sopr: bucket e coorti ora restituiscono anche btc_volume, usd_volume e cost_basis_usd; ogni periodo restituisce first_date, last_date e days. I nomi delle coorti possono usare qualsiasi sistema di scrittura; nomi duplicati e intervalli di età sovrapposti vengono rifiutati con 422.

2026-10-18​

Correzione dei dati

  • Net Liquidity (macro_net_liquidity): la componente Reverse Repo veniva sottratta senza conversione di unità, sovrastimando il livello fino a ~$2T nel 2021–2023 (ad es. 2022-06-01: $6.16T, in precedenza mostrato come $8.12T). L'intero storico è stato ricalcolato. La serie viene ora pubblicata per ogni giorno lavorativo USA anziché settimanalmente.
  • Bitcoin treasuries (/v1/dat/*): le detenzioni di una parte delle società e dei governi monitorati erano ferme ai valori del 2026-08-10. Lo storico per 2026-08-11 → 2026-10-16 è stato corretto e gli aggregati ricalcolati.
  • Totali ETF (/v1/etf/aggregate): Grayscale Mini veniva contato due volte nel periodo 2024-07-31 → 2026-07-18, sovrastimando le detenzioni totali degli ETF fino a ~48.000 BTC (es. 2025-06-02: 1.301.052 BTC, prima 1.344.415). Detenzioni totali, AUM, dominance di BTC, numero di ETF, quote di mercato e prezzo realizzato degli ETF sono stati ricalcolati.
  • WisdomTree Bitcoin Fund (BTCW) è ora conteggiato come ETF spot USA: us_btc_holdings, us_aum e il prezzo realizzato degli ETF spot USA lo includono dal 2024-01-11.
  • Le descrizioni di etf_realized_price e us_spot_etf_realized_price ora riflettono il calcolo effettivo (somma del costo medio ponderato per fondo / BTC detenuti); i valori non cambiano.

Flussi degli ETF

  • I flussi giornalieri sono ora allineati alla data di negoziazione per ogni fondo.
  • Nuovi campi: flow_usd (/v1/etf/ticker) e us_spot_net_flow_usd (/v1/etf/aggregate) — flusso netto giornaliero in USD.
  • Corretti i flussi storici di FBTC e IBIT e colmati i giorni mancanti (ad es. ARKB 2026-09-21).
  • Aggiunto MSBT (Morgan Stanley Bitcoin Trust).
  • flow_usd e us_spot_net_flow_usd coprono ora l'intero storico dal 2024-01-11; l'ultimo giorno è provvisorio finché tutti i fondi non pubblicano il proprio dato.
  • Flussi cumulati in USD ricalcolati dal flusso giornaliero esatto in USD: us_spot_cumulative_money_flow è ora la somma di us_spot_net_flow_usd dal 2024-01-11 (56,9 mld $ al 2026-10-16, in precedenza stimato in 83,3 mld $). etf_cumulative_money_flow usa il flusso esatto per gli ETF spot USA; gli ETP non statunitensi e GBTC prima del 2024 restano una stima (variazione di BTC × prezzo di BTC).
  • I grafici ETF Net Flow e ETF Net Flow Comparison mostrano ora il flusso in USD accanto a quello in BTC.

Derivati

  • BitMEX è stato rimosso da open interest e funding dopo la chiusura dell'exchange (i dati fino al 2026-09-16 sono conservati).
  • Aggiunti i funding rate di Kraken e Bitfinex.

2026-09-04​

Correzione dei dati

  • I prezzi giornalieri storici di BTC (OHLC) per 2026-04-17 → 2026-07-11 sono stati corretti per allinearli alla nostra fonte di riferimento. Le serie derivate dal prezzo — realized volatility (1w–1y) e price drawdown — sono state ricalcolate per l'intervallo interessato.
  • Realized Cap by Age (<24h) e la ripartizione Realized Cap by Age (%) per il 2026-07-06 e il 2026-07-07 sono stati ricalcolati (in precedenza sottostimati).
  • Nessun'altra metrica è stata interessata: realized cap, MVRV, NUPL e le serie degli holder restano invariate.

2026-05-17​

Snapshot API

  • L'output SVG è ora un formato di prima classe accanto al PNG. Il campo format di POST /v1/chart/snapshot accetta "png", "svg" o "json"; sia GET che POST onorano anche Accept: image/svg+xml.
  • Nuova route: GET /v1/chart/renders/{render_id}.svg — gli SVG renderizzati vengono conservati per 1 ora e sono recuperabili nuovamente tramite URL, replicando il comportamento esistente del formato .png.
  • Le risposte SVG ora includono X-Render-Id, così l'URL persistente può essere ricostruito da una singola chiamata di rendering.
  • Le varianti PNG e SVG dello stesso grafico vengono memorizzate nella cache in modo indipendente.
  • Gli overlay di performance dei cicli (x_axis: "day_offset") ora mostrano le etichette dei tick dell'asse X come date di calendario prese dall'ultimo ciclo della famiglia scelta (es. Oct '25, Jan '26, … per gli overlay ATH ancorati a cycle_ath_5 → 2025-10-06) anziché Day 0, Day 90, … . I cicli precedenti restano allineati sulle stesse posizioni dell'asse.

MCP Server

  • render_chart: l'enum del parametro format è ora "png" | "svg" | "json" (era "png" | "json"). Quando viene passato format: "svg", lo strumento restituisce un blocco di contenuto image/svg+xml e un URL /chart/renders/{id}.svg nel riepilogo.

2026-04-02​

Metrics & API

  • Numero di metriche ampliato da 127 a oltre 210 metriche attive (exchange, derivati, DAT e altro).
  • Nuovo endpoint: GET /v1/cycle-boundaries — date di inizio/fine e durate dei cicli di halving di Bitcoin.
  • La Metrics API ora utilizza un query builder basato su registry per una formattazione coerente delle risposte.

Snapshot API

  • Rendering di heatmap: renderizza grafici basati su distribuzioni (es. Cost Basis Distribution) con scale di colore configurabili (viridis, plasma, ecc.) e scale dell'asse Y. Include la legenda della scala di colore.
  • Grafici con overlay di performance dei cicli: x_axis: "day_offset" allinea tutti i cicli di halving al Day 0 per il confronto.
  • Nuovo parametro per metrica: show_in_legend — controlla se le singole metriche compaiono nella legenda del grafico.

MCP Server

  • Nuovo strumento: get_cycle_boundaries — interroga le date dei cicli di halving direttamente dagli agenti AI.
  • render_chart ora supporta il rendering di heatmap e gli overlay di performance dei cicli.
  • Codebase TypeScript unificato (tools.ts) per tutti gli strumenti MCP.
  • Numero di strumenti: 18 → 19.

2025-09-25​

  • Configurazione iniziale del sito di documentazione docs.blocklens.co.