chainid 解决的是“查哪条链”

Etherscan V2 API 的 chainid 不是装饰参数，它决定请求落在哪条支持的网络上。EVM 链经常使用相同格式的地址，同一个地址字符串在不同网络上可能有完全不同的余额、交易和合约记录。把 chainid 选错，得到的不是小误差，而可能是另一条链的数据。

官方支持链列表用于确认可查询网络。交易列表等接口还要结合 module、action、address、startblock、endblock 等参数。对开发者来说，正确做法是把 chainid、接口、地址、时间范围一起记录，方便以后复查数据来源。

查询前的最小清单

先确定业务问题：你是查以太坊主网交易，还是查 Base、Arbitrum、BSC 等网络？再去 Etherscan 支持链列表确认对应 chainid。不要只根据钱包里显示的代币名称判断网络。

其次确认接口。地址交易、ERC-20 转账、合约源码、日志事件属于不同接口，返回字段也不同。将普通交易列表误当代币转账列表，会漏掉重要记录。

最后保存请求上下文。API 返回结果应记录请求 URL、查询时间、chainid 和分页参数。若用于内容、审计或客服说明，最好同时附上区块浏览器页面链接，便于非技术用户核对。

常见误判

链上查询结果为空，不一定代表没有资产，可能只是网络错、接口错或分页范围错。接口返回成功，也不代表地址安全或合约可信。API 是查询工具，不是风控结论。

站内可继续看 WalletConnect弹窗识别、Permit2授权风险、硬件钱包地址替换，把链上查询和钱包操作放在一起核验。

风险提示

本文不提供 API Key、隐私数据或投资判断。Etherscan 支持链、接口字段和配额可能调整，请以访问时官方文档为准。涉及资产转移或合约交互时，API 查询只能辅助判断，不能替代独立风险评估。