代币快照工具使用教程

什么是代币快照？

代币快照（Token Snapshot）是一款强大的链上数据提取工具。它可以帮助您在特定的时间点，获取持有某一特定 ERC20 代币的所有钱包地址及其持仓余额。

常见应用场景：

• 空投投放：获取持币名单，为忠实用户发放奖励。

• 白名单筛选：筛选出持有一定数量代币的核心用户。

• 项目分析：分析代币的持仓分布情况（筹码集中度）。

• 社区治理：根据快照时的持币量分配投票权。

---

🛠 操作步骤

第一步：加载代币信息

1. 输入合约地址：在搜索框中粘贴您想要查询的 ERC20 代币合约地址（例如在 BSC 或以太坊上的代币地址）。

2. 校验地址：系统会自动识别地址格式。如果地址合法，点击 [加载信息] 按钮。

3. 确认数据：加载成功后，卡片下方会显示代币的名称、符号以及当前的总持币地址数。

第二步：配置下载参数

在生成快照前，您可以根据需求自定义导出规则：

1. 导出数量 (Top 排名)：

   • 设置您想要获取的前多少名持有者（例如：Top 1000）。

   • 您可以使用下方的快速选择按钮（100, 500, 1000...）快速设定。

2. 最低持有量过滤：

   • 如果您只想获取“大户”名单，可以设置一个最低持有金额。

   • 示例：输入 100，则只有余额大于等于 100 个代币的地址会被包含在快照中。

3. 选择导出格式：

   • CSV (推荐)：支持 Excel 或 Google Sheets 打开，包含地址和余额两列，适合数据分析。

   • TXT：纯文本格式，适合程序读取或批量导入其他工具。

   第三步：生成并下载

   1. 启动抓取：点击 [生成快照] 按钮。

   2. 等待进度：

      • 系统将通过区块链索引接口分批次抓取数据。

      • 页面会显示实时进度条。由于链上数据庞大，抓取大量地址（如超过 10,000 个）可能需要数十秒时间，请勿关闭页面。

   3. 保存文件：抓取完成后，浏览器会自动弹出下载窗口。文件名格式通常为 Snapshot_代币符号_日期.csv。

   💡 核心功能特性

• 游标分页技术：采用高效的 Cursor 分页逻辑，确保抓取大量数据时不会出现漏单或重复。

• 实时格式化：自动处理代币精度（Decimals），导出的余额即为用户在钱包中看到的实际数量。

• 多链支持：支持以太坊、BSC 等主流 EVM 兼容链的代币快照。

• 零成本过滤：在下载前完成本地过滤，节省您的数据处理时间。

---

❓ 常见问题 (FAQ)

Q: 为什么搜索不到我的代币？

A: 请检查：

1. 合约地址是否正确（不要输入您的钱包地址）。

2. 网络是否匹配（例如代币在 BSC 链，请确保工具也连接在 BSC 网络）。

3. 代币是否刚部署，索引可能存在几分钟的延迟。

Q: 导出数量有上限吗？

A: 为了保证浏览器性能和下载稳定性，建议单次导出数量控制在 50,000 条以内。如果持币地址极多，建议通过设置“最低持有量”来缩小范围。

Q: 导出的余额包含质押中的代币吗？

A: 本工具抓取的是代币合约内记录的直接持有余额。如果用户的代币已转入质押池（Staking Pool）或流动性池（LP），则不会统计在内，除非该质押合约提供了镜像代币。

---

温馨提示：快照数据具有时效性。如果您是为了一次特定的空投，建议在发布快照公告的时刻立即执行抓取。