Changelog

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

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.

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).

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.

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.

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.

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.