> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onlydev.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# 批量查询余额

> 粘贴地址列表，批量读取原生币或 ERC20 余额，支持导出 CSV

# 批量查询余额

> 粘贴多个 **地址**（无需私钥），按链批量读余额；只读不上链，不发交易。

***

## 填写参数

侧边栏进入 **批量查询余额**，在 **查询配置** 里按顺序填：

| 字段          | 必填 | 说明                                                                |
| ----------- | -- | ----------------------------------------------------------------- |
| **网络**      | 是  | 与地址、代币所在链一致                                                       |
| **RPC 节点**  | 是  | HTTPS RPC；可测速、用 **推荐** 或粘贴自备节点（同链与其他批量工具 [共用](/guide/custom-rpc)） |
| **每批数量**    | 是  | 每批 multicall 查几个地址，**默认 200**（1～1000）。地址很多时可适当调小，减轻 RPC 超时        |
| **间隔 (ms)** | 是  | 两批之间的等待，**默认 500**。公共节点易限速时可加大                                    |
| **查询代币**    | 是  | **原生币**：表格只显示原生币余额。**ERC20**：同时显示原生币 + 该代币两列                      |
| **地址列表**    | 是  | 每行一个 `0x…` 地址；顶部显示有效 / 无效数量                                       |

**地址列表** 格式示例：

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
0xabc...
0xdef...
0x123...
```

* 空行忽略；同一地址重复出现会标 **重复的地址**
* 有无效行时，点 **移除 N 个无效地址**，或手动改好再查
* **须无无效行** 才能点 **开始查询**

改 **网络**、**查询代币** 或 **地址列表** 后，旧结果会清空，需重新查询。

***

## 查询与结果

1. 参数填好后点 **开始查询**；进度条显示批次进度，可 **停止**
2. 下方出现 **查询结果**：汇总条 + 表格（地址、余额、成功/失败）
3. 表格列可排序；失败行余额显示 `—`，不阻断其他地址
4. **导出 CSV**：下载当前表格
5. **刷新余额**：用同样参数重新读链（查最新块）

大批量或公共 RPC 偶发失败时：换 [付费节点](/guide/custom-rpc)，或调小 **每批数量**、加大 **间隔** 后 **刷新余额** 重试。

***

## 高级功能：指定区块高度（历史快照）

默认查 **最新区块** 余额。若需要某地址在 **过去某一时刻** 的余额（做快照、对账、回溯），可解锁 **区块高度** 字段。

### 解锁方式

在 **查询配置** 卡片标题 **「查询配置」** 上 **连续点击 5 次**（约 1.5 秒内），出现「已解锁高级查询」提示后，下方会出现 **区块高度** 输入框。

### 怎么用

| 区块高度     | 含义           |
| -------- | ------------ |
| **留空**   | 查最新区块（默认）    |
| **填正整数** | 查该区块高度时的余额快照 |

1. 填入区块号（如 `14523456`），输入后会自动校验区块是否存在，并显示对应 **日期 / 距今**
2. 校验通过后再点 **开始查询**，结果区顶部会标注 **查询基准块**（块高 + 时间）
3. **导出 CSV** 可保存该快照；历史模式下点 **刷新余额** 会提示无需刷新（链上历史数据不会变）

### 节点要求（归档节点）

历史查询依赖 RPC 的 **archive（归档）** 能力 — 节点须能返回 **过去任意区块** 的状态。多数 **免费公共节点** 只保留近期状态，**不支持** 此功能。

请使用支持 archive 的 **付费节点**，例如：

* [QuickNode](https://www.quicknode.com/) — 按文档 [配置付费 RPC](/guide/custom-rpc) 创建的 Endpoint **默认即可**用于历史查询
* [GetBlock](https://getblock.io/) 等需选用 **归档节点** 套餐

在本页 **RPC 节点** 粘贴上述节点的 HTTPS URL；配置方式见 [配置付费 RPC](/guide/custom-rpc)。

若节点不支持，开始查询时会提示类似 **「当前 RPC 不支持历史状态查询（非 archive 节点）」** — 换归档节点即可。

<Tip>
  历史快照与 **查询代币**、**地址列表** 用法相同：选原生币只查原生余额；选 ERC20 则同时查原生币 + 代币在该区块的余额。
</Tip>

***

## 相关

* [批量转账](/guide/batch-transfer)
* [批量汇集](/guide/batch-collect)
* [配置付费 RPC](/guide/custom-rpc)