Bubblemaps 历史持仓怎么比较：对齐日期、持有人范围、过滤和评分
链小知 · 进阶 · 核验 · 依官方文档整理
用Time Travel建立两份可复查历史视图，排查top holder变化、手动节点、隐藏账户和评分量纲；图变分散不直接证明大户卖出或风险消失。
开始前准备
- 准备同一网络/完整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、产品、范围和节点设置都可比，未知范围已标出。
2. 用图表或日期选择器定位两个时点
在V2点价格图表上的目标时间，或用date picker选第一个日期，保存页面实际显示时点；再按同一方式选择第二个。记录选择时点和地图实际计算/显示时间，不把某个价格点当即时持仓快照。
页面时区未注明时，保留原显示并标待确认，不默认UTC或北京时间。若已有API历史请求，timestamp是文档规定的Unix时间输入，须保留原值及单位来源；日期没数据、加载失败或仅返回当前状态时，不补一张假历史图。
检查结果：两次选择的实际显示时间与可用性明确，时区/输入单位未知没有被擅自换算。
3. 逐地址比较份额，不只比较颜色
针对关注地址分别查看两个时点的持仓数量、份额、rank和所属cluster，写成前后对照。top holders随分布变化，一个地址从图上消失可能落出范围或被隐藏，不能直接写余额为零；新增节点也可能是手动/算法加入。
通过Address List加入需要跟踪的公开地址，并记录Manually Added身份；必要时从Show All Transfers按对应时间、资产和方向找到已有变化线索。加入地址只扩展观察，不自动证明它在两个时点都是持有人或一定发生出售。
检查结果：每个地址的可见/隐藏/范围外/缺数据与实际余额字段分开，变化有原值支持。
4. 对齐聚类和隐藏规则再解读分散变化
用相同Magic Nodes、Time Nodes、资产和金额过滤比较两个时点；把中间地址及抽象时窗当关系条件，而不是新持仓人。服务/合约节点默认隐藏会改变所见连接，Supernode限制也使某些关系不可见。
如已有API导出，检查use_magic_nodes/use_time_nodes和return_nodes/return_relationships；缺关系字段可能只是默认未返回，不能解释为无转账。share采用0–1；供给份额变低、cluster变小仍需原转账和供给变化记录才能判断是出售、转移还是范围改变。
检查结果：聚类差异与数据/显示条件先被分开，缺字段和抽象节点不被当成资产变化。
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。
检查结果：分数、调整份额和实体数量保持独立尺度，且分别注明排除/检测范围。
6. 保存两份可重复的视图和费用边界
分别生成permalink并记录日期、过滤及手动地址；需要地址列表时使用export，确认它导出的是当前图范围，不当成全链全部持有人。比较结论写为“在这些相同条件下可见份额/关系变化”，不直接认定实际共控人数或卖出原因。
已有API记录还要对照X-Dt-Update/metadata更新时间和缓存条件。文档中历史timestamp、扩大limit、return_nodes或refresh会加credits，V2免费声明不覆盖这些调用；没有数据或权限时保留待核，不通过付费刷新来制造验收。
检查结果：两份链接/导出范围/时间与结论可回查，未知数据、价格或访问条件未被掩盖。
怎样确认完成
- 保存同链同token的两份日期与可比参数，逐地址记录实际值、范围和无法判断的原因。
- 只完成官方流程与字段核验；没有真实历史地图/API回执、钱包操作或控制人归因验收。
常见错误与边界
- 旧图与新图持有人数/隐藏条件不同，却把视觉变化全归于大户卖出。
- 图里找不到地址就把余额补0；return_relationships未开启当作零关系。
- 分散评分等同安全评级，或把调整entities/cluster份额当原始钱包总余额。