# GoldRush

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/goldrush

提供地址余额、交易等结构化链上数据的 API 与 SDK；适合核对整数余额、索引时间和报价口径。

官方入口：https://goldrush.dev/
类别：数据与研究
网络：Ethereum
访问条件：Foundational API 需 GoldRush API key；可先用脱敏响应核对，不需连接钱包。API key 仅放受控服务器或本地环境。
费用：官方 Token Balances 端点标每次请求 1 credit；额度和套餐以当前账号为准，x402 支付是独立通道。

## 用途
- 核对地址 Token Balances 响应
- 换算 balance 与 decimals
- 检查报价缺失及索引时间
- 分清 spam 过滤与资产安全

## 使用边界
- Ethereum 来自 balances_v2 的 eth-mainnet 示例；端点、Foundational Chains 与其他产品网络范围不能相互外推。
- 此余额端点返回原生币与可替代 Token，NFT 与详细交易需要相应其他接口。
- quote/quote_rate 可缺失，is_spam/no-spam 只是筛选信号，不证明资产或合约安全。
- 数据经过索引；应同时记录 updated_at 与链 tip，而非当成钱包即时可提现余额。

## 操作教程
- [GoldRush 余额和估值对不上：检查 decimals、quote 与索引时间](https://lianxiaozhi.com/tools/guides/goldrush-token-balance-units-freshness)：用已有 Token Balances 响应核对最小单位、原生币标志和数据时间，避免把报价缺失当余额为零。

## 相关知识

## 官方依据
- [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)
