# Tensor 合集查询缺项：核对身份过滤、页码与验证字段

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/guides/tensor-collection-pagination-verified-check
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

把展示slug、合集ID、链上collection mint和first verified creator分开，再按原请求条件对照每页结果，解释列表缺项而非凭名称判断合集不存在。

## 使用工具
- [Tensor](https://lianxiaozhi.com/tools/tensor) · [官方入口](https://www.tensor.trade/)

## 前置条件
- 一组已有脱敏的GET /api/v1/collections请求参数与响应；没有记录时可用本页方法schema逐项建立核对表。
- 记录请求日期、mainnet baseURL、sortBy、limit/page及过滤值；移除x-tensor-api-key，不上传凭据。
- 核对对象为Tensor Data API1.0.0 Alpha参考，非钱包资产列表或所有Solana链上合集。

## 1. 确认方法与请求资格

在官方Get Verified Collections页确认GET https://api.mainnet.tensordev.io/api/v1/collections。记录所在mainnet环境与参考版本，把响应文件和请求日期配对。

请求认证在x-tensor-api-key头；公开读文档不代表可以匿名调用。Quickstart的key申请对象是大型trader/market-maker或公共项目，先核对已有记录属于获准访问的产品，认证值留在原系统中。

核对结果：核对表保留baseURL、方法、日期及资格状态；没有响应的部分标“待核”，不填空列表。
依据：[Tensor REST API Alpha 与访问资格](https://dev.tensor.trade/reference/quickstart.md)
依据：[Tensor Get Verified Collections OpenAPI](https://dev.tensor.trade/reference/getcollections-1.md)

## 2. 按身份字段选择过滤

把tensor.trade/trade/路径中的展示标识放入slugDisplays，响应的合集ID用collIds。vocs是verified on-chain collection mints，fvcs是first verified creators；不要把NFT单枚mint、展示名称或任意creator替代这两类过滤。

从已有记录选择一个身份条件核对；需要组合时完整保留原组合，不猜多个条件的AND/OR规则。原文写max 10 vocs/fvcs，不将它扩写成两组各10个的总20额度。

核对结果：每个过滤值都有来源与类型；同名合集仍用collId和对应链上身份分别记录。
依据：[Tensor Get Verified Collections OpenAPI](https://dev.tensor.trade/reference/getcollections-1.md)

## 3. 锁定排序与从1开始的页码

sortBy与limit必填，limit为1–100；page最小1。可按官方枚举写核对示例sortBy=slugDisplay:asc、limit=20、page=1；这只是参数示例，不是已调用结果。

比较第2页时保持同一sortBy、limit与过滤值。statsV2.volume24h:desc等滚动指标排序可能随着请求时刻变化，页面没有提供跨页固定快照承诺，不能仅因重复项断言后台错误。

核对结果：页号不是0起点，比较页的过滤与排序一致；请求时刻变化单独标出。
依据：[Tensor Get Verified Collections OpenAPI](https://dev.tensor.trade/reference/getcollections-1.md)

## 4. 逐页核对结果与缺项范围

响应使用collections数组、total和page，不是cursor/next分页。记录每页collections.length、响应page、total与全部collId；发现重复ID时先保留重复的位置，再计算这一组已取得记录的唯一ID数。

200空数组只能说明该时刻这组已记录条件下没有结果或到达空页；方法本身只描述verified collections，不等于全链合集全集。若total变化、缺中间页或仍未覆盖后续页，将盘点状态写成不完整。400保存message；422按Validation Error核对参数，不把错误页纳入资产计数。

核对结果：能说明缺项来自身份过滤、页缺失、排序变动、方法范围或仍未知；没有把缺项写成合集销毁。
依据：[Tensor Get Verified Collections OpenAPI](https://dev.tensor.trade/reference/getcollections-1.md)

## 5. 把验证、白名单和隐藏标记分列

准确读取tensorVerified、tensorWhitelisted、hidden与flagReason；这些字段不是同一个verified开关。slugDisplay、tokenStandard、tokenProgram、flagReason允许null；缺字段或null分别保留，不转成false、空字符串或假定SPL_TOKEN。

compressed和tokenProgram描述资产程序/形式，页面枚举也包含SPL_TOKEN_2022、MPL_CORE、BUBBLEGUM，但枚举不是所有交易流程支持验收。验证/白名单标记不等于版权授权、项目安全或图片真实性；对身份仍以对应mint/creator与collId核对。

核对结果：输出逐collId对照表，包含原始状态值、过滤来源、页与日期；未知标记没有被补成结论。
依据：[Tensor Get Verified Collections OpenAPI](https://dev.tensor.trade/reference/getcollections-1.md)
依据：[Tensor Foundation 协议与 Solana 范围](https://docs.tensor.foundation/)

## 常见错误
- 把slugDisplay、collId、collection mint与first verified creator视为同一个字符串。
- 把GET verified collections当全部链上合集，或将tensorWhitelisted自动解释为tensorVerified。
- 仅依据一页、滚动排序或400/422响应判断目标合集不存在。
- 此Alpha参考与当前实际API权限、费用和字段兼容未实测；不能把文档允许值当全部程序的当前交易支持。

## 完成检查
- 形成带请求条件、时间、页范围与collId的结果对照表。
- 每个遗漏项都有证据支持的分支或保留未知；区分验证/白名单/隐藏与资产真实性。

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

## 官方依据
- [Tensor REST API Alpha 与访问资格](https://dev.tensor.trade/reference/quickstart.md)
- [Tensor Get Verified Collections OpenAPI](https://dev.tensor.trade/reference/getcollections-1.md)
- [Tensor Foundation 协议与 Solana 范围](https://docs.tensor.foundation/)