> For the complete documentation index, see [llms.txt](https://help.bananatool.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.bananatool.org/token/token-snapshot.md).
# 代币快照工具使用教程
代币快照教程：使用 BananaTool 在 BSC、Ethereum 等 EVM 网络读取 ERC20 持有人名单，按 Top 数量和最低持有量筛选并导出 CSV。
BananaTool「代币快照」用于读取 EVM 公链上的 ERC20 持有人数据，并将地址与对应余额导出为文件。项目方可以用它整理空投名单、设置社区白名单、分析持仓分布，或在活动开始前保存某一时点的持仓记录。
本文按照官网当前页面说明选择公链、加载代币信息、配置导出数量和最低持有量、生成 CSV，并介绍索引延迟、快照口径和数据核验方法。入口：[BananaTool 代币快照](https://www.bananatool.org/token-snapshot)。
{% hint style="warning" %}
快照只读取公开链上数据，不需要私钥、助记词或钱包签名。不要在代币快照页面输入任何敏感凭据；合约地址、网络和快照时间必须在导出前后复核。
{% endhint %}
## 一、代币快照能做什么
代币快照会根据指定公链和 ERC20 合约，获取索引服务提供的持有人地址及余额，并按页面配置导出结果。常见用途包括：
* **空投和奖励**：按快照时点整理符合条件的钱包地址。
* **白名单筛选**：使用最低持有量筛选核心持有人。
* **持仓分析**：查看 Top 持有人和余额分布。
* **社区治理**：将快照结果交给治理规则或投票系统进一步处理。
快照是某个数据读取时点的结果，不会冻结余额，也不会阻止持有人继续转账。交易所内部余额、尚未被索引的地址、质押合约中的代币是否计入，取决于代币合约和索引服务的统计口径。
## 二、使用前准备
开始前准备：
* 目标 ERC20 代币的**合约地址**，不要使用个人钱包地址或交易 Hash。
* 合约所在的公链，例如 BSC、Ethereum、Base 或其他 EVM 网络。
* 需要导出的排名数量，例如 Top 100、Top 1000。
* 可选的最低持有量门槛，以及用于保存 CSV 的本地目录。
* 快照用途和时间记录，方便后续空投、白名单或报告核对。
建议从项目官网、区块浏览器的合约页或已验证的部署记录复制合约地址。相同的 `0x` 地址可能在多条链上存在，但每条链的代币和持有人数据互不相同。
## 三、选择公链并加载代币信息
1. 打开 [BananaTool 代币快照](https://www.bananatool.org/token-snapshot)。
2. 在「公链配置」的「选择公链」中选择代币实际部署的网络。官网当前空状态示例显示 `BSC`。
3. 在「选择代币」输入框粘贴完整的 ERC20 合约地址，格式通常为 `0x` 加 40 位十六进制字符。
4. 点击「加载信息」。按钮会在地址格式可用时启用。
5. 等待页面读取链上基础信息和持有人数量，核对名称、符号、精度、合约地址和持有人数量。
选择公链并加载 ERC20 代币信息
如果加载失败，先检查网络和合约地址是否匹配，再尝试刷新页面或稍后重试。不要因为同名代币就直接确认，必须以合约地址为准。
## 四、检查代币信息和快照摘要
加载成功后，页面的「代币信息」区域会显示基础资料，右侧「快照摘要」会同步展示本次配置，包括：
* 合约地址和代币名称/符号。
* 当前索引到的持有人数量。
* 导出数量，例如 `Top 1000`。
* 最低持有量，默认通常为 `0`。
* 导出格式，官网当前默认显示 `CSV`。
先确认摘要中的代币、网络和数量，再进行筛选。持有人数量是索引服务返回的统计值，可能因同步时间与区块链实时状态存在短暂差异。
## 五、设置导出数量和最低持有量
### 导出数量（Top 排名）
导出数量决定最多保留多少名持有人。常见选择是 Top 100、Top 500 或 Top 1000；如果页面提供自定义输入，可按业务需求填写更大数量。数量越大，抓取和浏览器处理时间越长。
选择排名时要写入活动记录，例如「区块高度/时间 + Top 1000」，避免把不同批次的名单混淆。
### 最低持有量过滤
最低持有量用于筛选余额达到门槛的钱包。例如输入 `100`，仅保留余额大于或等于 100 个代币的地址。门槛按代币实际显示数量理解，页面会根据代币精度格式化余额。
官网当前提示：最低持有量过滤会在数据抓取完成后于本地执行。因此即使设置了较高门槛，页面仍可能先读取较多持有人数据；不要在生成过程中关闭页面。
### 导出格式
当前页面默认提供 CSV，文件包含地址和对应余额两列，适合 Excel、Google Sheets 或脚本读取。打开 CSV 后检查列名、地址完整性和余额精度，不要让表格软件把地址改成科学计数法或自动去掉字符。
确认快照摘要和导出参数
## 六、生成并下载快照
1. 再次核对公链、合约地址、代币符号和快照配置。
2. 点击右侧「生成快照」。
3. 等待索引服务返回数据和页面完成本地最低持有量过滤。
4. 生成过程中不要刷新、关闭标签页或切换到其他网络。
5. 下载完成后，使用本地工具打开 CSV，检查地址数量、排序、余额和文件编码。
页面提示文件会保存地址与对应余额两列。建议使用带日期、网络和代币符号的文件名，并同时记录查询时间、区块高度（如果页面或区块浏览器可查）和合约地址。快照文件包含项目地址名单，尽量存放在受控目录，不要公开上传。
生成前确认提示和数据口径
## 七、核验快照结果
导出后建议进行以下检查：
1. 随机抽取几条地址，在目标网络区块浏览器查看 ERC20 余额。
2. 对照 CSV 的地址数量与页面快照摘要中的导出数量。
3. 检查最低持有量过滤是否符合预期，特别是余额等于门槛的地址。
4. 确认代币精度、余额小数位和 CSV 编码没有被表格软件改写。
5. 对空投或白名单用途，去除明确不应参与的合约地址、黑名单地址或项目自有地址，并保留剔除记录。
快照数据来自索引服务，区块链刚发生大量转账时可能存在同步延迟。重要活动可在指定区块高度再次核对，必要时使用区块浏览器或合约 `balanceOf` 查询抽查结果。
## 八、空投和运营使用建议
快照文件不等同于最终发放名单。用于空投前应额外完成：
* 去重并统一地址大小写展示规则。
* 排除交易所热钱包、LP、质押合约和项目自有地址（是否排除由活动规则决定）。
* 明确最低持有量、快照时间、网络和代币合约，并在公告中公开口径。
* 使用[批量转账教程](/tools/multisend.md)前重新核对收款地址和金额。
* 在小批次测试成功后再执行正式发放。
## 九、常见问题
### 为什么搜索不到我的代币？
确认合约地址完整、没有输入钱包地址，并检查选择的公链是否正确。新部署或近期交易较多的代币可能仍在索引服务同步中，稍后重试并以区块浏览器核对基础信息。
### 持有人数量和区块浏览器不一致怎么办？
不同平台的统计口径、快照时间、是否排除零余额地址及索引延迟可能不同。记录查询时间和网络后，随机抽查地址并以目标区块高度的数据作为活动最终口径。
### 最低持有量过滤在哪里执行？
官网当前提示是在数据抓取完成后本地执行。导出数量较大时仍需等待完整抓取，过滤不会让前端立即跳过所有数据请求。
### 质押或流动性池里的代币会被统计吗？
如果代币已经转入质押合约或 LP 合约，通常会作为这些合约地址的直接余额统计；用户在质押协议中的份额不一定能从 ERC20 持有人列表还原。是否排除这些地址应根据活动规则人工处理。
### 快照会实时更新吗？
不会。快照是生成时读取到的数据副本，生成完成后余额变化不会自动同步到文件。需要新的口径时，应重新选择网络和合约生成一份新快照。
### 导出的 CSV 可以直接用于批量空投吗？
只能作为地址和余额参考。空投前还要检查地址格式、排除规则、金额计算、网络和 Gas，并先用小批次测试。请参考[批量转账教程](/tools/multisend.md)。
## 相关教程
* [批量检查钱包余额教程](/tools/batch-check-balance.md)
* [批量转账（一转多）教程](/tools/multisend.md)
* [批量归集（多转一）教程](/tools/collection.md)
* [标准 ERC20 / BEP20 代币创建](/token/standard.md)
* [BananaTool 工具导航](/gong-ju-dao-hang.md)