Changelog

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

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.