在Web3与NFT的世界中，Collection（集合）是组织和展示数字资产的基础单元。它代表了一个或多个合约地址中的所有资产，帮助用户将同一创作者的项目进行归类。每个集合通常拥有一个或多个所有者，并关联着关键元数据，如创作者版税和项目描述。
Collection模型的核心组成
Collection模型包含了多个关键参数，每个参数都承载着特定的信息与功能。
基本信息参数
- name (字符串): 集合的名称，用于直观识别。
- des (字符串): 集合的详细描述，阐述其背景、理念或特性。
- image (字符串): 集合标志性图标的URL地址。
- backgroundImage (字符串): 集合背景图片的URL地址，用于增强展示效果。
- slug (字符串): 集合的唯一标识符，在系统内部用于精准定位。
社交与认证信息
- certificateFlag (布尔值): 集合的官方认证标志，true代表已通过平台认证。
- officialWebsite (字符串): 集合的官方网站链接。
- 社交媒体链接: 包括
instagramUrl,discordUrl,mediumUrl,twitterUrl等，指向集合在各个社交平台的官方页面，用于社区建设和用户互动。
分类与资产信息
- categoryList (数组): 集合所属的类别列表，便于分类浏览和发现。
- assetContracts (数组): 一个由资产合约模型(Asset Contract Model) 对象组成的数组，详细说明了与此集合关联的智能合约信息。
市场统计数据
- stats (对象): 一个包含该集合相关市场统计数据的字典，具体结构遵循集合统计模型(Collection Stats Model)，例如交易量和地板价等。
深入解析资产合约模型 (Asset Contract Model)
资产合约模型定义了与集合关联的智能合约的具体细节，是理解资产底层协议的关键。
- chain (字符串): 该合约所部署的区块链网络。
- contractAddress (字符串): 与集合关联的合约地址。
- tokenStandard (字符串): 合约的代币协议标准，例如 ERC-721 或 ERC-1155。
- ownerAddress (字符串): 该合约的所有者地址。
- erc2981 (布尔值): 标识该合约是否支持 ERC-2981 协议，该协议用于实现创作者版税的自动化分配。
掌握集合统计模型 (Collection Stats Model)
集合统计模型提供了集合在市场中的表现数据，对于评估其流行度和价值至关重要。
- latestPrice (字符串): 该集合最近一次的销售价格。
- totalVolume (字符串): 该集合的历史总销售 volume。
- totalCount (字符串): 该集合包含的NFT资产总数。
- ownerCount (字符串): 该集合的持有者总数。
- floorPrice (字符串): 该集合中所有挂牌资产的最低价格，即地板价。
这些模型共同构成了NFT集合的完整数据画像，从基础信息、合约底层细节到市场动态，为开发者构建应用和用户做出决策提供了全面的数据支撑。👉 查看实时市场数据与更多API功能
常见问题
什么是Collection（集合）？
Collection是Web3中用于将同一或多个智能合约下的NFT资产进行归组的逻辑单元。它通常代表一个完整的NFT项目，包含所有相关的资产、元数据以及市场统计信息。
assetContracts参数为什么是数组？
一个集合可以包含来自多个智能合约的资产。例如，一个项目可能同时在以太坊和Polygon链上发布NFT，或者使用不同的合约来区分不同系列的作品。因此，assetContracts 是一个数组，用以容纳所有关联的合约信息。
ERC-2981协议有什么作用？
ERC-2981是一个NFT版税标准。当合约支持此协议（即erc2981为true）时，能在每次NFT转售时自动向创作者地址支付预先设定比例的版税，保障了创作者的持续收益。
如何利用Collection数据？
开发者可以利用这些模型数据构建NFT市场、画廊、分析工具或钱包应用。用户则可以据此评估项目的真实性（认证标志）、社区活跃度（社交媒体链接）、流动性（交易量和地板价）和稀缺性（总数和持有者数）。
slug和name有什么区别？
name是集合的显示名称，可以被更改且不一定唯一。而slug是经过处理的唯一字符串标识符，通常用于生成URL和API调用中，以保证精确指向某个特定集合。
Collection的认证标志（certificateFlag）意味着什么？
该标志由平台授予，表明该集合已经过官方审核和验证，通常是项目真实性和官方性的重要保证，有助于用户规避风险。