# NFTScan API / SDK

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

NFT数据接口及官方JavaScript/TypeScript SDK。核对EVM持有列表、ERC1155数量、大Token ID与元数据字段，区分当前产品入口、固定源码与真实后台响应。

官方入口：https://docs.nftscan.com/
类别：NFT、身份与社交
网络：Ethereum、BNB Chain、Polygon、OP Mainnet、Base、Solana
访问条件：公共文档与源码可匿名读；官方SDK要求开发者账户API-KEY，HTTP实现发送X-API-KEY。教程使用官方字段或既有脱敏响应，不需要提交账户密钥。
费用：公开平台与FAQ采用CU用量收费并列最低199美元购买；公开页面1USDT/1百万units、FAQ1USD/1百万CU措辞分别保留。特定方法CU、免费资格与实际账户限流未核实；定制页QPS最高200不是默认权限。

## 用途
- 用游标盘点已有NFT持仓记录
- 区分资产行数与ERC1155持有数量
- 保留大Token ID及元数据空值
- 解释固定SDK解包与版本不一致

## 使用边界
- 网络仅列固定SDK1.15.0支持表/enum的已有站内规范例子；Solana使用独立SDK，不将EVM资产参数原样套用。当前官方入口确认产品类别，不证明每链实时服务完整覆盖。
- SDK范围固定于5ab7fe77baf804ebde1cd938e7bd74d3bc2f7e51（commit日期2026-07-01）；未核实npm最新包、线上后端版本或运行结果。
- README的ARBITRUM例子与固定enum/BASE_URL不一致，未据旧示例收录Arbitrum支持。FAQ的付款网络及未来链计划也不是数据支持矩阵。
- 具体实时参考页与Overview仅取得无方法正文的客户端shell；重要参数与字段依据固定官方源码。
- ERC1155 owner/own_timestamp等注释允许null而TS类型不允许，不能把类型声明当真实数据保证；API刷新提交与完成也不同。

## 操作教程
- [NFTScan 持仓数量不对：核对游标、ERC1155 amount与截断](https://lianxiaozhi.com/tools/guides/nftscan-owned-assets-cursor-erc1155-count)：按照固定官方SDK1.15.0复核已有EVM资产记录，逐页保存next/cursor，把资产条目数和持有份数分开，排除铸造列表及多链截断造成的误计。
- [NFTScan 大Token ID与元数据空值：保留精度、URI和毫秒时间](https://lianxiaozhi.com/tools/guides/nftscan-large-token-id-metadata-null-check)：按链+合约+字符串Token ID定位已有NFT记录，核对十六/十进制、metadata_json、显示属性及ERC1155空值，避免精度损失和字段类型误判。

## 相关知识
- [如何核对 Meme 币？先确认链、合约地址和交易池](https://lianxiaozhi.com/learn/meme-token-identity)
- [原始、解码和整理后的链上数据有什么区别？](https://lianxiaozhi.com/learn/raw-decoded-curated-data)
- [把数据上链，与只保存数据哈希有什么区别？](https://lianxiaozhi.com/learn/data-onchain-vs-offchain)
- [链上指标历史数值为什么会变？](https://lianxiaozhi.com/learn/point-in-time-metrics)

## 官方依据
- [NFTScan 官方文档产品入口](https://docs.nftscan.com/)
- [NFTScan Developer Platform 计费说明](https://developer.nftscan.com/)
- [NFTScan 公共定价页](https://docs.nftscan.com/pricing)
- [NFTScan Developer FAQ](https://developer.nftscan.com/faq)
- [NFTScan 固定官方 SDK README](https://raw.githubusercontent.com/nftscan-official/nftscan-api-js-sdk/5ab7fe77baf804ebde1cd938e7bd74d3bc2f7e51/README.md)
- [NFTScan 固定 EVM asset 方法实现](https://raw.githubusercontent.com/nftscan-official/nftscan-api-js-sdk/5ab7fe77baf804ebde1cd938e7bd74d3bc2f7e51/src/api/evm/asset/index.ts)
- [NFTScan 固定 EVM asset 参数](https://raw.githubusercontent.com/nftscan-official/nftscan-api-js-sdk/5ab7fe77baf804ebde1cd938e7bd74d3bc2f7e51/src/types/evm/asset/request-params.ts)
- [NFTScan 固定 EVM Asset 与多链响应类型](https://raw.githubusercontent.com/nftscan-official/nftscan-api-js-sdk/5ab7fe77baf804ebde1cd938e7bd74d3bc2f7e51/src/types/evm/asset/response-data.ts)
- [NFTScan 固定 SDK 通用类型与游标](https://raw.githubusercontent.com/nftscan-official/nftscan-api-js-sdk/5ab7fe77baf804ebde1cd938e7bd74d3bc2f7e51/src/types/nftscan-type.ts)
- [NFTScan 固定 SDK HTTP 解包与认证](https://raw.githubusercontent.com/nftscan-official/nftscan-api-js-sdk/5ab7fe77baf804ebde1cd938e7bd74d3bc2f7e51/src/http/nftscan.http.ts)
- [NFTScan 固定 SDK 链与路径常量](https://raw.githubusercontent.com/nftscan-official/nftscan-api-js-sdk/5ab7fe77baf804ebde1cd938e7bd74d3bc2f7e51/src/util/nftscan.const.ts)
- [NFTScan 固定 SDK 包版本](https://raw.githubusercontent.com/nftscan-official/nftscan-api-js-sdk/5ab7fe77baf804ebde1cd938e7bd74d3bc2f7e51/package.json)