NFTScan能查什么?多链NFT数据与API用法

NFT 的链上数据有一个特点:散。同一个人可能在五条链上都有持仓,同一个合集可能有三套合约(原版、迁移版、代理升级版),同一笔交易在两条链上各有一份记录。NFTScan 这类平台的价值,就是把这些散落的数据按地址、按合集、按链聚起来。这篇讲它能查什么、怎么用它做尽调,以及四个必须自己核对的地方。

NFTScan能查什么?多链NFT数据与API用法

上图是多链 NFT 缩略图拼成的网格,每张图下面挂着数据标签——这正是这类平台的核心:把图和数据对上。

它是什么:一个多链 NFT 数据层

NFTScan 的定位是多链 NFT 数据基础设施,提供两种使用方式:网页端浏览器查询,和面向开发者的 API。网页端适合人工核查,API 适合批量拉取和做监控。

它覆盖多条主流链,具体链数以官网公示为准——这句话不是免责,而是必要的:链的覆盖范围会变,新链接入、旧链停止支持,都会影响你查到的结果。开工前先看一眼支持列表,比事后发现数据缺失要省事。

需要区分的是「NFT 数据平台」和「NFT 交易市场」。前者不撮合交易,只提供数据和索引;后者才是买卖的地方。这个区别决定了它的收费模式:数据平台按调用量和订阅收费,市场按成交抽佣。

四类查询:地址、合集、交易、API

第一类是地址持仓。输入一个钱包地址,能看到它在各条链上持有哪些 NFT、属于哪些合集、大概值多少。这一类的使用频率最高,因为它是所有尽调的起点。

第二类是合集数据。输入一个合集,能看到总供应量、持有人数、地板价、成交量、铸造历史。这部分数据要和交易市场的地板价对照看,两边口径可能不一样。

第三类是交易记录。按地址、按合集、按时间筛选,能看到 mint、transfer、sale 三类事件。这一类是做资金追踪的核心。

第四类是 API。把上面三类能力变成接口,可以按地址拉持仓、按合集拉统计、按区块范围拉事件。对做监控和报表的团队来说,这一类的价值最大。

举个具体的用法:你要跟踪一个项目方地址有没有在偷偷卖货,就写一个定时任务,每天拉一次它的持仓,和昨天比。持仓减少就告警。这件事用网页端要每天手动点,用 API 是十几行代码的事。

一个具体场景:查一个陌生钱包

假设有人在社群里发了个地址,说这是某项目的国库。你先看它在几条链上有 NFT、集中在哪个合集、最近 30 天有没有转出。三步下来,这个地址是真国库还是临时钱包,基本就有答案了。

用它做尽调:三个具体动作

第一个动作,查项目方地址是否自持大量 NFT。做法是拿到项目官方公布的国库地址或者部署者地址,看它的持仓。如果它持有一个合集 30% 以上的供应量,那这个合集的「分散度」是假的,地板价随时可以被砸穿。

第二个动作,查合集的真实持有人数。注意「持有人数」和「持币地址数」不是一回事:一个人可以有十个地址,交易所的一个热钱包也可能持有几千个 NFT。看持有人数时,最好配合持币分布一起看,剔除交易所和已知的做市地址。

第三个动作,查版税与洗量。版税收入能反映真实成交——刷量的交易通常不走版税,或者走的是自设的低版税市场。把版税收入和成交额放在一起看,比值异常低,就说明成交量里有水分。

这三个动作不需要写代码,网页端就能完成,半小时足够。做完之后你会有一个大致判断:这个合集是真有人在收藏,还是只有做市商在自己跟自己交易。

下图把四类入口的使用占比做了示意分布,可以对照上面几步看自己主要在用哪一类:地址持仓和合集数据占了大头,API 调用占比最小,但单位价值最高。

NFTScan四类查询入口的使用占比(示意,%)

四个核对点:链覆盖、延迟、合约识别、历史

第一,链覆盖。你要查的 NFT 在哪条链上?如果平台不支持那条链,你看到的就是「零持仓」,而不是「没有持仓」。这两个结论差别很大。

第二,数据延迟。链上数据从产生到被索引,有一个时间差。热门链通常几分钟,冷门链可能几小时。做监控时要考虑这个延迟,别把「还没索引到」当成「没有发生」。

第三,合约识别。这是最容易被低估的一点。很多 NFT 合集用代理合约,逻辑合约换过好几次;有的项目迁移过合约,旧合约还挂着;还有的跨链 NFT 在不同链上是不同的合约地址。平台如果不能正确识别这些关系,你查到的「合集数据」就是残缺的。

第四,历史完整度。早期区块的数据可能没有被完整索引,尤其是 2017 到 2019 年的老合集。查老项目时,先确认平台的历史起点,否则你会以为「这个合集只有最近三年的交易」。

API 用法:从免费额度开始

如果你要写代码,建议的顺序是:先申请一个免费或试用额度,用少量地址跑通「拉持仓 → 拉合集统计 → 拉事件」这三条链路,再决定要不要上付费档。

调用时注意三件事。第一,分页。持仓和事件接口通常有分页限制,一次拉几百条,要写循环。第二,限流。多数平台按秒或者按天限流,批量任务要加退避重试。第三,字段含义。不同平台的字段命名不一样,「floor_price」可能是不含税的地板价,也可能是最近成交价,用之前先看文档。

商用授权要单独确认。免费额度通常只允许非商业用途,做产品要买商用授权,具体条款以官网为准。这一点很多人忽略,等到产品上线才被发现,代价不小。

NFTScan能查什么?多链NFT数据与API用法

上图是四个查询入口的图标:地址持仓、合集数据、交易记录、API 调用。用哪个,取决于你要回答什么问题。

它和区块浏览器、 marketplace 自带数据的区别

区块浏览器给你的是「原始事实」:某笔交易、某个地址的转账记录。它不负责聚合,也不会告诉你「这个地址一共持有多少个合集」。

交易市场给你的是「交易视角」:挂了什么单、成交了什么价。但市场只看自己平台内的数据,跨平台的持仓它不一定知道。

数据平台给的是「聚合视角」:把多个链、多个市场的记录拼在一起。它的优势是全局,代价是依赖索引质量。三者不是替代关系,是互相校验的关系——数据平台给结论,浏览器给证据,市场给价格。

三个常见误用

第一个,把「持有人数」当「用户数」。一个地址可能是一个人,也可能是一万个。持有人数只说明分布,不说明规模。

第二个,把「地板价」当「价值」。地板价是最便宜那一件卖单的价格,不代表整个合集的价值。流动性差的时候,地板价和成交价能差很远。

第三个,把「成交量」当「需求」。NFT 的成交量可以刷,尤其是低版税市场出现之后,刷量成本大幅下降。

一个实用的核查顺序

第一步,确认链。第二步,确认合约地址(别用名字搜)。第三步,看持有人分布,剔除交易所地址。第四步,看版税收入与成交额的比值。第五步,看历史交易的连续性——有没有长时间的空白期。

五步走完,你对这个合集的判断会比看官网介绍准确得多。官网介绍的是「愿景」,链上数据是「事实」。

风险提示

第一,数据误差风险。第三方索引可能漏块、延迟或者误识别合约,关键结论建议用两个来源交叉验证。

第二,合约风险。NFT 合约可能有增发、改版税、暂停转移等权限,数据平台不评估这些权限的安全性。

第三,市场风险。NFT 流动性远低于同质化代币,极端行情下可能完全没有买盘。

第四,政策风险。境内虚拟货币相关业务活动属于非法金融活动,本文只做数据工具用法的信息梳理,不构成投资建议。

下图把核对 NFT 数据服务的四个点按重要度打分:数据延迟和合约识别并列最高,因为这两项错了,后面全错。

核对NFT数据服务的四点(1-5,越高越重要,示意)