# Ankr 余额对不上：核对 API 入口、区块标签与 wei

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/guides/ankr-check-ethereum-balance-units
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

从既有 eth_getBalance 记录定位原生 ETH 余额差异，排除索引型接口、pending 状态和十六进制单位误读。

## 使用工具
- [Ankr RPC](https://lianxiaozhi.com/tools/ankr) · [官方入口](https://www.ankr.com/rpc/)

## 前置条件
- 准备预期 Ethereum 网络、完整公开账户地址、已有脱敏 endpoint、请求、响应和采样时间。
- 准备对照余额的来源及其区块号或状态；未知对照口径时先记为不可比较。

## 1. 确认使用 Chain RPC

检查 endpoint 路径：标准 Ethereum 方法使用 rpc.ankr.com/eth/<API_KEY> 一类链入口，multichain/<API_KEY> 是 Advanced API。两者共用主机和 key，但任务与方法不同；不要把索引型多链代币列表当 eth_getBalance 的原始结果。记录主机及链路径，隐藏 key。

核对结果：记录中 method 为 eth_getBalance，入口是对应 Ethereum Chain RPC。
依据：[Ankr：两类 API 的入口与认证](https://www.ankr.com/docs/api-reference/)

## 2. 核对账户和区块输入

eth_getBalance 的 params 依次是完整 20 字节地址和区块号/标签。固定历史块用十六进制区块号；最新状态用 latest，候选状态用 pending，更严格的确认口径按 safe/finalized 分别记录。对照两个不同状态的余额时先解释口径差异，不直接判节点错误。

核对结果：地址完全一致，双方区块号或标签可对应，网络和采样时间已保存。
依据：[Ankr：Ethereum 余额、区块标签与 wei](https://www.ankr.com/docs/rpc-service/chains/chains-api/ethereum/web3/)

## 3. 将十六进制 wei 转成 ETH

先看 JSON-RPC error，再取 result；它是十六进制数量、单位 wei。用大整数解析后以 10^18 为比例显示 ETH，避免先转浮点数丢精度。例如示意值 0xde0b6b3a7640000 等于 10^18 wei，即 1 ETH；该示意不代表你的查询余额。eth_getBalance 查的是原生币，ERC-20 余额不能据此判零。

核对结果：原始 result、十进制 wei 和显示 ETH 三者留存，单位明确且无浮点截断。
依据：[Ankr：Ethereum 余额、区块标签与 wei](https://www.ankr.com/docs/rpc-service/chains/chains-api/ethereum/web3/)
依据：[Ankr：两类 API 的入口与认证](https://www.ankr.com/docs/api-reference/)

## 4. 区分状态差异与读取失败

latest 可随链头重组变化，pending 取决于节点候选状态，因此两个标签不同的读数不必相等。失败响应、未知网络或缺失 result 记为读取失败，不改成余额 0。无论是否成功都保存响应口径，必要的后续核查只针对同一账户与状态。

核对结果：余额差异已有明确口径或保留待查；失败与零值分别呈现。
依据：[Ankr：Ethereum 余额、区块标签与 wei](https://www.ankr.com/docs/rpc-service/chains/chains-api/ethereum/web3/)

## 5. 按套餐整理用量边界

核对当前是 Public、Freemium 还是 Premium；Advanced API 权限和限流不能照搬普通 RPC。Premium 按 API credits 收费，节点返回错误不一定代表不收费；service plans 对不可解析请求与 429 等另列规则，应按真实请求分类复核。给排查报告附套餐与调用类型，别把 credits 直接写成请求次数。

核对结果：输出网络、账户、区块口径、原始单位、差异原因及服务用量口径。
依据：[Ankr：套餐、功能、限流与计费](https://www.ankr.com/docs/rpc-service/service-plans/)

## 常见错误
- ETH 原生余额与 ERC-20 同名或其他链资产属于不同查询。
- pending 不代表已最终确认的账户余额。
- URL 路径含个人 key，分享排查记录前需遮盖。

## 完成检查
- 可以复核同账户同状态的原生余额，或明确指出网络、区块、单位和错误造成的不可比。
- 仅完成官方文档核验；示意转换不是 Ankr API 实测回执。

## 相关知识
- [区块确认与最终性是什么？交易成功和充值到账为何不同步](https://lianxiaozhi.com/learn/confirmations-and-finality)
- [Gas 怎么计算？交易失败为什么仍可能扣费](https://lianxiaozhi.com/learn/gas-and-failed-transactions)

## 官方依据
- [Ankr：两类 API 的入口与认证](https://www.ankr.com/docs/api-reference/)
- [Ankr：Ethereum 余额、区块标签与 wei](https://www.ankr.com/docs/rpc-service/chains/chains-api/ethereum/web3/)
- [Ankr：套餐、功能、限流与计费](https://www.ankr.com/docs/rpc-service/service-plans/)