跳到主要内容

更新日志

本页记录 Blocklens 平台及 API 的所有重要变更。

2026-10-22​

清算地图（新仪表板，Lab → Dashboards → Blocklens Special）

  • 显示未平仓的杠杆头寸会在哪些价格被强制平仓：Hyperliquid — 实际持仓（每个未平仓持仓及其清算价格，每日扫描）和 Binance — 模型（根据未平仓合约和常见杠杆估算的价位）——可并排或单独查看，支持 BTC、ETH、SOL 和 HYPE。
  • 清算热力图（随时间变化）（每一天的地图及价格线；可缩放，点击某一天即可打开当日地图）和 当前地图（各价格区间的清算规模，附累计曲线、主要聚集区和覆盖率）。
  • Hyperliquid 提供 排除最大的 20 个持仓 开关；Binance 模型窗口不完整的日期以及在存档快照之间重建的日期均标记为估算。
  • 所有用户均可导出 PNG，Pro 可导出 CSV/JSON；支持收藏和可分享的链接。
  • 套餐： Free — 最近 30 天和当前地图；Pro — 完整历史。

图表

  • Charts → Futures → Liquidation maps：两个来源的热力图和当前地图分别作为独立图表提供。

API & MCP

  • 新增清算地图端点（Liquidation Map API）以及 MCP 工具 get_liquidation_map 和 get_liquidation_heatmap，套餐限制相同。

地图如何构建以及能说明什么、不能说明什么：清算地图方法论。清算地图是一种描述性工具，而非价格目标或交易信号。

2026-10-19​

Cohort Spending Analysis（Enterprise 仪表板）

  • 数据修正： 对于超过两年的区间，每个内部加载边界处的周或月被重复计算（例如 2019-12-30 这一周显示为 ₿2.3M，而非 ₿1.14M），且年度 SOPR 为近似值（2018 年的 LTH SOPR 显示为 1.10，而非 1.33）。两者现已与源数据完全一致。对于位于 UTC 以东的用户，日期不再偏移一天。
  • 不完整的首个/最后一个周期会标记为部分周期；默认 cohort 现以 1d（年龄恰好 1 天）和 1d–1w（2–6 天）开头。
  • 长区间加载更快，BTC/USD 即时切换，仪表板状态（区间、聚合方式、单位、标签页、日期、自定义 cohort）保存在可分享的链接中。
  • Market X-Ray 打开时默认显示对比（最新周期 vs ~1M/3M/6M/1Y 之前），周期按年份选择，列按 cohort 标注。
  • Cohort Breakdown 新增 成交量占比 % 视图、cohort SOPR 叠加层以及亏损花费的占比；SOPR Pulse 默认使用对数刻度。
  • Cohort 编辑器在应用前会校验名称和区间；日期和数字按您的语言格式显示；导出文件（PNG/CSV/JSON）与当前标签页显示的内容完全一致。

API

  • POST /v1/enterprise/sopr：bucket 和 cohort 现在还会返回 btc_volume、usd_volume 和 cost_basis_usd；每个周期返回 first_date、last_date 和 days。Cohort 名称可使用任意文字；重复名称和重叠的年龄区间将以 422 拒绝。

2026-10-18​

数据修正

  • Net Liquidity（macro_net_liquidity）：Reverse Repo 分量在扣减时未做单位换算，导致 2021–2023 年的水平被高估最多约 ~$2T（例如 2022-06-01：$6.16T，此前显示为 $8.12T）。已重新计算全部历史。该序列现按美国每个工作日发布，而非每周发布。
  • Bitcoin treasuries（/v1/dat/*）：部分被跟踪公司和政府的持仓停留在 2026-08-10 的数值。已修正 2026-08-11 → 2026-10-16 的历史并重新计算汇总值。
  • ETF合计（/v1/etf/aggregate）：2024-07-31 → 2026-07-18 期间 Grayscale Mini 被重复计算，使ETF的BTC总持仓最多高估约4.8万BTC（例如 2025-06-02：1,301,052 BTC，此前为 1,344,415）。总持仓、AUM、BTC占比、ETF数量、市场份额和ETF已实现价格均已重新计算。
  • WisdomTree Bitcoin Fund（BTCW） 现计入美国现货ETF：自 2024-01-11 起包含在 us_btc_holdings、us_aum 和美国现货ETF已实现价格中。
  • etf_realized_price 和 us_spot_etf_realized_price 的说明现与实际计算一致（各基金加权平均成本之和 / 持有的BTC）；数值不变。

ETF 资金流

  • 每日资金流现已对所有基金按交易日对齐。
  • 新字段：flow_usd（/v1/etf/ticker）与 us_spot_net_flow_usd（/v1/etf/aggregate）——以 USD 计的每日净流入。
  • 已修正 FBTC 与 IBIT 的历史资金流，并补齐缺失日期（例如 ARKB 2026-09-21）。
  • 新增 MSBT（Morgan Stanley Bitcoin Trust）。
  • flow_usd 和 us_spot_net_flow_usd 现已覆盖自 2024-01-11 起的完整历史；在所有基金公布数据之前，最新一天为临时值。
  • 累计美元流量已重新计算，基于准确的每日美元流量：us_spot_cumulative_money_flow 现为自 2024-01-11 起 us_spot_net_flow_usd 的总和（2026-10-16 为 $569 亿，此前估算为 $833 亿）。etf_cumulative_money_flow 对美国现货ETF使用准确流量；美国以外的ETP和2024年之前的GBTC仍为估算（BTC变化 × BTC价格）。
  • ETF Net Flow 和 ETF Net Flow Comparison 图表现在在BTC流量旁显示美元流量。

衍生品

  • 交易所关闭后，BitMEX 已从 open interest 与 funding 中移除（保留截至 2026-09-16 的数据）。
  • 新增 Kraken 与 Bitfinex 的 funding rate。

2026-09-04​

数据修正

  • 已将 2026-04-17 → 2026-07-11 的 BTC 历史每日价格（OHLC）修正为与我们的参考数据源一致。价格衍生序列——realized volatility（1w–1y）与 price drawdown——已针对受影响区间重新计算。
  • 已重新计算 2026-07-06 与 2026-07-07 的 Realized Cap by Age (<24h) 及 Realized Cap by Age (%) 拆分（此前被低估）。
  • 其他指标不受影响：realized cap、MVRV、NUPL 及 holder 系列保持不变。

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}.svg URL。

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 文档站点的初始搭建。