核对一个钱包的 NFT 家底，多数人的路径是打开市场应用看资产页。但市场展示层有自己的索引与过滤，做审计、交接或纠纷取证时，更需要绕开界面直接问数据源。Etherscan 的公开接口里有一组专门针对 ERC-721 持仓的端点，文档把它们归在钱包与投资组合的用例下；把三类查询各自的能力边界弄清楚，个人也能搭起一套不依赖任何市场平台的自查流程。
第一类是地址持仓概览。文档里的端点是 module=account、action=addresstokennftbalance，给一个地址，返回它持有的 ERC-721 合约列表，每项带合约地址、名称、符号和数量四个字段，支持翻页。它回答的是这个地址在多少个系列里有多少枚，粒度停在合约层。文档同时标注这是一个 PRO 端点，面向标准档及以上的套餐开放，免费密钥调用会撞上权限边界——这是很多教程截图里看不到的差别，动手前先查自己账户的套餐说明。第二类是同系列的编号明细端点，按地址加合约返回该系列下持有的具体代币编号列表，做单系列清点时比概览更顺手。
第二类是逐笔记录。action=tokennfttx 返回一个地址的 ERC-721 转账流水，进出都算，文档在投资组合用例里特意说明它的用途是展示每件藏品何时被买入或卖出。它属于经典免费档就能调用的端点族，也是三兄弟里最抗审查的一个：不管展示层把某个合集标成什么状态，转账事件是协议层的既成事实。审计自己账户的历史、确认某笔转走是否真实发生、还原交割时间线，都从它开始。给地址、加链号、翻页码数，返回结构与普通的 ERC-20 转账流水同构。
第三类是多链参数。Etherscan 在 2023 年后把各链接口收敛到 v2 网关，统一地址形态换成带 chainid 参数的请求，以太坊主网填 1，其他受支持链填各自编号，文档维护着受支持链清单。对持有跨链藏品的用户，这意味着一套脚本、一个密钥就能按链切换查询，不必再为每条链记不同的域名和端点前缀；反过来也要留意，v2 覆盖的是官方清单内的链，清单外的链仍得去各自的浏览器找接口。
实操上有几个高频坑值得提前知道。持仓概览返回空数组并不等于地址没有 NFT：地址可能只在某条未接入 v2 的链上有资产、可能只持有 ERC-1155 或比特币铭文这类不在此端点口径内的对象、也可能索引存在延迟——把空结果直接翻译成没有持仓，是自查流程里最常见的越界推理。数量字段的口径是合约余额的派生，与索引器看到的 Transfer 事件流理论上应当对账一致，不一致时以逐笔流水为准，必要时再拿链上原始日志复核。签名与铸造的权限状态不在这些端点的职责范围内，需要另走授权查询。把端点当探针、把结论留给自己下，这类工具的价值才用得干净。
端点之外还有两个实操细节值得写进备忘。速率与配额：免费密钥每秒调用次数有限，批量任务需要加退避重试；文档同时注明部分端点的结果存在缓存周期，持仓数字并非严格实时，脚本若把两次拉取的差异直接理解为持仓变动，会得出错误结论，比对时间戳应当以区块号或时间参数为锚。字段口径：返回中的代币名称与符号来自合约链上数据，合约没写的字段会以空串出现，仿冒合集正是利用这一点——名称相同、合约地址不同，只有地址才是唯一键，一切跨来源比对必须以合约地址为主键，把名称当主键的报表会在蹭名潮里成批出错。把这些细节纳入使用习惯，接口数据才能稳定支撑起审计结论。
本文为机制说明，不构成任何投资建议。
发表评论
还没有评论，来说两句吧。
评论区为展示样式，提交不会被处理。