# GoldRush 余额和估值对不上：检查 decimals、quote 与索引时间

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

用已有 Token Balances 响应核对最小单位、原生币标志和数据时间，避免把报价缺失当余额为零。

## 使用工具
- [GoldRush](https://lianxiaozhi.com/tools/goldrush) · [官方入口](https://goldrush.dev/)

## 前置条件
- 准备已脱敏的 balances_v2 请求和 JSON 响应，包含 chainName、walletAddress 与请求时间。
- 实时 Foundational API 需 GoldRush API key，余额端点每次 1 credit；可直接分析既有响应，无需钱包或发起新的付费请求。

## 1. 固定端点与响应范围

检查记录是 /v1/{chainName}/address/{walletAddress}/balances_v2/，官方 Ethereum 示例用 eth-mainnet。先判断响应 error，再读 data；错误响应或认证/限流失败不能当空资产列表。该端点用于原生币与可替代 Token，NFT 不应按同一列表推断。

核对结果：端点、链名、地址和成功/失败状态完整，资产范围明确。
依据：[GoldRush：地址 Token Balances 接口](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address)
依据：[GoldRush：官方 API 索引、认证与数值口径](https://goldrush.dev/docs/llms.txt)

## 2. 按合约身份选中一条余额

从 items 找到目标 contract_address，同时核对 contract_ticker_symbol、is_native_token 和 contract_decimals。同名 Token 可以是不同合约；原生币也有独立标志。保存这一条的 balance 原始字符串，不先从 quote 排名挑选币种。

核对结果：网络、合约地址、原生币标志、精度与 balance 可逐项回查。
依据：[GoldRush：地址 Token Balances 接口](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address)

## 3. 按 decimals 做整数缩放

人类数量为 balance ÷ 10^contract_decimals。例如纯算术样例 balance="1234500"、decimals=6，应得到 1.2345；这不代表所有稳定币都有 6 位。用大整数/十进制定点运算，避免 JavaScript Number 直接吞掉大额整数尾数。

核对结果：换算可回算为原始 balance，显示位数没有被另一币种的精度覆盖。
依据：[GoldRush：官方 API 索引、认证与数值口径](https://goldrush.dev/docs/llms.txt)
依据：[GoldRush：地址 Token Balances 接口](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address)

## 4. 区分余额、报价和时间

把 quote、quote_rate、quote_currency 与余额分开记录；报价缺失不能推出 Token 数量为零。再核对 updated_at、chain_tip_height、chain_tip_signed_at 以及条目的 block_height；两个数据源不同区块或报价时刻，估值自然可能不一致。

核对结果：数量、价格、计价币、索引时间和链高度分别有值或明确缺失标记。
依据：[GoldRush：地址 Token Balances 接口](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address)

## 5. 检查过滤与特殊 Token 范围

若未找到资产，检查 no-spam 查询选项及 is_spam；它们是疑似垃圾资产过滤，不能据此认定合约安全或余额不存在。rebasing 支持限定于 Foundational Chains，不从其他链数据推断。整理缺失字段、过滤参数和网络后再申请进一步查询，别靠反复收费重试猜原因。

核对结果：缺失归因为错误响应、过滤、网络/端点范围或待核，而非直接记为零。
依据：[GoldRush：地址 Token Balances 接口](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address)
依据：[GoldRush：官方 API 索引、认证与数值口径](https://goldrush.dev/docs/llms.txt)

## 常见错误
- quote 为零或空和 balance 为零不是同一事实。
- 同一 ticker 不足以定位合约，必须带网络和 contract_address。
- 索引余额、钱包即时状态和可转出额度是不同问题；spam 标志不是安全审计。

## 完成检查
- 输出含端点/链/地址、目标资产身份、原始余额与换算、估值和索引时间。
- 核验为官方文档及接口字段检查；未调用实时或付费接口。

## 相关知识

## 官方依据
- [GoldRush：地址 Token Balances 接口](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address)
- [GoldRush：官方 API 索引、认证与数值口径](https://goldrush.dev/docs/llms.txt)