用途:为需要链上数据的应用提供统一 REST 接口,覆盖 100+ 条链的历史与近实时数据,涵盖代币余额、交易、NFT、安全授权、跨链活动、价格和区块数据。
主要能力:余额类接口支持代币与原生币余额、历史余额、组合价值、ERC20 转账、代币持有者及比特币地址;交易类支持近期交易、分页历史、单笔查询、汇总与区块级交易;另有 NFT 持仓与所有权验证、代币/NFT 授权、地址活跃链、多链余额与交易;工具类提供代币价格、区块与高度、事件日志、Gas 价格、链元数据、池现货价格与地址解析。
使用方式:优先使用官方客户端 SDK,例如 TypeScript 安装 npm install @covalenthq/client-sdk,通过 new GoldRushClient("YOUR_API_KEY") 调用各服务方法;也可直接使用 HTTP,例如 curl "https://api.covalenthq.com/v1/eth-mainnet/address/demo.eth/balances_v2/" -H "Authorization: Bearer YOUR_API_KEY"。认证使用 Authorization: Bearer,仅支持 HTTPS。
关键规则与限制:链名大小写敏感,如 eth-mainnet;分页从 0 开始,每页 100 条;访问 data 前先检查 error;代币余额为字符串,需除以 10^contract_decimals;ENS 域名可直接作为地址传入;计价货币默认 USD;可用 no-spam=true 过滤垃圾代币;TypeScript SDK 内建重试与限流处理。历史余额、任意区块的代币持有者、池现货价格与 tracing 标志属于 Foundational 专属功能。
参考资料文件包括 overview.md、endpoints-balances.md、endpoints-transactions.md、endpoints-nft-security-crosschain.md、endpoints-utility.md、integration-guide.md 与 workflows.md,用于查询完整参数、响应结构、链名表、错误码与工作流规划。费用与价格信息暂未提供。