# Bubblemaps 历史持仓怎么比较：对齐日期、持有人范围、过滤和评分 整理：链小知（AI 辅助） 资料核对日期：2026-10-12 引用地址：https://lianxiaozhi.com/tools/guides/bubblemaps-time-travel-holder-scope-score-check 难度：进阶 核验方式：官方文档整理，未执行真实账户操作 用Time Travel建立两份可复查历史视图，排查top holder变化、手动节点、隐藏账户和评分量纲；图变分散不直接证明大户卖出或风险消失。 ## 使用工具 - [Bubblemaps](https://lianxiaozhi.com/tools/bubblemaps) · [官方入口](https://bubblemaps.io/) ## 前置条件 - 准备同一网络/完整token地址、两个待比较日期、关注的完整地址清单，以及已有地图链接或公开记录。日期是观察目标，不保证该产品对每个时点都有数据。 - 只查看地图与已有去敏导出，不使用Swap、连接/持币解锁、标签提交或付费API。高级功能/历史数据不可访问时记录边界。 - V2、iFrame和Data API有不同默认范围；API参考为Data API0.3.1的/v0接口，不能把界面名称V2当成/v2 API路径。 ## 1. 固定同一资产和比较范围 先确认两张图的网络/token完全相同，再记录产品版本、top holder范围、隐藏地址、Magic/Time Nodes及转账过滤。V2教程默认250，可扩500；API/iFrame默认80，API limit支持80/250/500；高级1000持有人是另一个访问条件。 不要把一张第三方iFrame的80人图和V2的250人图直接计算“新增关联人数”。如一张视图范围未知，先保留差异，不能为了对齐在尚未授权的API中强制增加limit。 核对结果：两份数据的token key、产品、范围和节点设置都可比，未知范围已标出。 依据：[Bubblemaps V2：节点、转账、过滤与地图时间](https://wiki.bubblemaps.io/bubblemaps-v2/how-does-it-work) 依据：[Bubblemaps V2：手动地址、转账过滤与范围扩展](https://wiki.bubblemaps.io/bubblemaps-v2/add-addresses) 依据：[Bubblemaps V2：基础免费与BMT高级功能边界](https://wiki.bubblemaps.io/bubblemaps-v2/premium) 依据：[Bubblemaps Data API 0.3.1：80持有人、可选参数及缓存](https://docs.bubblemaps.io/data/api/tokens/map.md) ## 2. 用图表或日期选择器定位两个时点 在V2点价格图表上的目标时间，或用date picker选第一个日期，保存页面实际显示时点；再按同一方式选择第二个。记录选择时点和地图实际计算/显示时间，不把某个价格点当即时持仓快照。 页面时区未注明时，保留原显示并标待确认，不默认UTC或北京时间。若已有API历史请求，timestamp是文档规定的Unix时间输入，须保留原值及单位来源；日期没数据、加载失败或仅返回当前状态时，不补一张假历史图。 核对结果：两次选择的实际显示时间与可用性明确，时区/输入单位未知没有被擅自换算。 依据：[Bubblemaps V2：图表与日期选择的历史视图](https://wiki.bubblemaps.io/bubblemaps-v2/time-travel) 依据：[Bubblemaps V2：节点、转账、过滤与地图时间](https://wiki.bubblemaps.io/bubblemaps-v2/how-does-it-work) 依据：[Bubblemaps Data API 0.3.1：80持有人、可选参数及缓存](https://docs.bubblemaps.io/data/api/tokens/map.md) ## 3. 逐地址比较份额，不只比较颜色 针对关注地址分别查看两个时点的持仓数量、份额、rank和所属cluster，写成前后对照。top holders随分布变化，一个地址从图上消失可能落出范围或被隐藏，不能直接写余额为零；新增节点也可能是手动/算法加入。 通过Address List加入需要跟踪的公开地址，并记录Manually Added身份；必要时从Show All Transfers按对应时间、资产和方向找到已有变化线索。加入地址只扩展观察，不自动证明它在两个时点都是持有人或一定发生出售。 核对结果：每个地址的可见/隐藏/范围外/缺数据与实际余额字段分开，变化有原值支持。 依据：[Bubblemaps V2：图表与日期选择的历史视图](https://wiki.bubblemaps.io/bubblemaps-v2/time-travel) 依据：[Bubblemaps V2：节点、转账、过滤与地图时间](https://wiki.bubblemaps.io/bubblemaps-v2/how-does-it-work) 依据：[Bubblemaps V2：手动地址、转账过滤与范围扩展](https://wiki.bubblemaps.io/bubblemaps-v2/add-addresses) ## 4. 对齐聚类和隐藏规则再解读分散变化 用相同Magic Nodes、Time Nodes、资产和金额过滤比较两个时点；把中间地址及抽象时窗当关系条件，而不是新持仓人。服务/合约节点默认隐藏会改变所见连接，Supernode限制也使某些关系不可见。 如已有API导出，检查use_magic_nodes/use_time_nodes和return_nodes/return_relationships；缺关系字段可能只是默认未返回，不能解释为无转账。share采用0–1；供给份额变低、cluster变小仍需原转账和供给变化记录才能判断是出售、转移还是范围改变。 核对结果：聚类差异与数据/显示条件先被分开，缺字段和抽象节点不被当成资产变化。 依据：[Bubblemaps V2：Magic Nodes中间地址](https://wiki.bubblemaps.io/bubblemaps-v2/magic-nodes) 依据：[Bubblemaps V2：时间节点是时窗抽象](https://wiki.bubblemaps.io/bubblemaps-v2/time-nodes) 依据：[Bubblemaps Data API 0.3.1：80持有人、可选参数及缓存](https://docs.bubblemaps.io/data/api/tokens/map.md) 依据：[Bubblemaps V2：节点、转账、过滤与地图时间](https://wiki.bubblemaps.io/bubblemaps-v2/how-does-it-work) ## 5. 按各自量纲解释评分和调整份额 记录Bubblemaps Score的0–100分散程度含义及可检测范围，不把分数上升当安全保证。V2评分说明只考虑检测到的holders/clusters，排除CEX/DEX/contracts等；隐藏或未检测关联不会变成“已经验证不存在”。 已有API指标中，top_10_adjusted是聚类后前10entities并排除服务账户，bundles是前10clusters，不能当10个独立钱包原始余额；supply_stats用0–1，Gini/HHI文档也有自己的0–1尺度，Nakamoto是达50%供给的entity数量。score=null是不可计算，不补0或100。 核对结果：分数、调整份额和实体数量保持独立尺度，且分别注明排除/检测范围。 依据：[Bubblemaps V2：可检测范围内的分散程度评分](https://wiki.bubblemaps.io/bubblemaps-v2/bubblemaps-score.md) 依据：[Bubblemaps API：调整份额与各自量纲](https://docs.bubblemaps.io/data/api/tokens/metrics.md) ## 6. 保存两份可重复的视图和费用边界 分别生成permalink并记录日期、过滤及手动地址；需要地址列表时使用export，确认它导出的是当前图范围，不当成全链全部持有人。比较结论写为“在这些相同条件下可见份额/关系变化”，不直接认定实际共控人数或卖出原因。 已有API记录还要对照X-Dt-Update/metadata更新时间和缓存条件。文档中历史timestamp、扩大limit、return_nodes或refresh会加credits，V2免费声明不覆盖这些调用；没有数据或权限时保留待核，不通过付费刷新来制造验收。 核对结果：两份链接/导出范围/时间与结论可回查，未知数据、价格或访问条件未被掩盖。 依据：[Bubblemaps V2：节点、转账、过滤与地图时间](https://wiki.bubblemaps.io/bubblemaps-v2/how-does-it-work) 依据：[Bubblemaps V2：基础免费与BMT高级功能边界](https://wiki.bubblemaps.io/bubblemaps-v2/premium) 依据：[Bubblemaps Data API 0.3.1：80持有人、可选参数及缓存](https://docs.bubblemaps.io/data/api/tokens/map.md) 依据：[Bubblemaps：API key、credits与限流](https://docs.bubblemaps.io/data/api/authentication) ## 常见错误 - 旧图与新图持有人数/隐藏条件不同，却把视觉变化全归于大户卖出。 - 图里找不到地址就把余额补0；return_relationships未开启当作零关系。 - 分散评分等同安全评级，或把调整entities/cluster份额当原始钱包总余额。 ## 完成检查 - 保存同链同token的两份日期与可比参数，逐地址记录实际值、范围和无法判断的原因。 - 只完成官方流程与字段核验；没有真实历史地图/API回执、钱包操作或控制人归因验收。 ## 相关知识 - [链上指标历史数值为什么会变？](https://lianxiaozhi.com/learn/point-in-time-metrics) - [浏览器上的价格和标签都是链上数据吗？](https://lianxiaozhi.com/learn/explorer-third-party-labels) - [原始、解码和整理后的链上数据有什么区别？](https://lianxiaozhi.com/learn/raw-decoded-curated-data) ## 官方依据 - [Bubblemaps V2：节点、转账、过滤与地图时间](https://wiki.bubblemaps.io/bubblemaps-v2/how-does-it-work) - [Bubblemaps V2：图表与日期选择的历史视图](https://wiki.bubblemaps.io/bubblemaps-v2/time-travel) - [Bubblemaps V2：手动地址、转账过滤与范围扩展](https://wiki.bubblemaps.io/bubblemaps-v2/add-addresses) - [Bubblemaps V2：Magic Nodes中间地址](https://wiki.bubblemaps.io/bubblemaps-v2/magic-nodes) - [Bubblemaps V2：时间节点是时窗抽象](https://wiki.bubblemaps.io/bubblemaps-v2/time-nodes) - [Bubblemaps V2：基础免费与BMT高级功能边界](https://wiki.bubblemaps.io/bubblemaps-v2/premium) - [Bubblemaps V2：可检测范围内的分散程度评分](https://wiki.bubblemaps.io/bubblemaps-v2/bubblemaps-score.md) - [Bubblemaps Data API 0.3.1：80持有人、可选参数及缓存](https://docs.bubblemaps.io/data/api/tokens/map.md) - [Bubblemaps API：调整份额与各自量纲](https://docs.bubblemaps.io/data/api/tokens/metrics.md) - [Bubblemaps：API key、credits与限流](https://docs.bubblemaps.io/data/api/authentication)