更新日志
本页记录 Blocklens 平台及 API 的所有重要变更。
2026-05-17
Snapshot API
- SVG 输出现已与 PNG 并列成为一等公民。
POST /v1/chart/snapshot的format字段接受"png"、"svg"或"json"；GET 和 POST 同时也支持Accept: image/svg+xml。 - 新增路由：
GET /v1/chart/renders/{render_id}.svg—— 渲染后的 SVG 会持久化保存 1 小时并可通过 URL 重新获取，与现有的.png行为一致。 - SVG 响应现在包含
X-Render-Id，因此可以从单次渲染调用中重建持久化 URL。 - 同一图表的 PNG 与 SVG 变体会被独立缓存。
- 周期表现叠加图（
x_axis: "day_offset"）现在将 X 轴刻度标签渲染为所选系列最新周期的日历日期（例如锚定于cycle_ath_5→ 2025-10-06 的 ATH 叠加图会显示Oct '25、Jan '26、……），而不再是Day 0、Day 90、…… 。较早的周期在同一坐标轴位置上保持对齐。
MCP Server
render_chart：format参数的枚举值现在为"png" | "svg" | "json"（原为"png" | "json"）。当传入format: "svg"时，该工具会返回一个image/svg+xml内容块，并在摘要中返回一个/chart/renders/{id}.svgURL。
2026-04-02
Metrics & API
- 指标数量从 127 个扩展至 210+ 个活跃指标（exchanges、derivatives、DAT 等）。
- 新增端点：
GET /v1/cycle-boundaries—— Bitcoin 减半周期的起止日期与持续时长。 - Metrics API 现在使用基于注册表的查询构建器，以实现一致的响应格式化。
Snapshot API
- 热力图渲染：以可配置的色阶（
viridis、plasma等）和 Y 轴刻度渲染基于分布的图表（例如 Cost Basis Distribution），并包含色阶图例。 - 周期表现叠加图：
x_axis: "day_offset"将所有减半周期对齐到 Day 0 以便比较。 - 新增逐指标参数：
show_in_legend—— 控制单个指标是否出现在图表图例中。
MCP Server
- 新增工具：
get_cycle_boundaries—— 直接从 AI 智能体查询减半周期日期。 render_chart现已支持热力图渲染和周期表现叠加图。- 为所有 MCP 工具统一了 TypeScript 代码库（
tools.ts）。 - 工具数量：18 → 19。
2025-09-25
docs.blocklens.co文档站点的初始搭建。