| name | nft-valuation |
| description | NFT估值工具，基于特征稀有度评分、地板价趋势与可比销售法进行估值。适用于数字藏品定价机制学习与。为工具，估值结果不可作为投资或定价依据，不反映市场流动性风险。 |
| version | 1.0.0 |
| author | wangyi |
nft-valuation
NFT 估值工具，实现稀有度评分（Rarity Score）、地板价分析、可比销售法估值与特征统计分析。仅使用 Python 标准库。
📌 说明：本工具基于简化模型实现和启发式方法。结果仅供学习参考，不构成投资建议或交易依据。
脚本API
calculate_trait_frequency(collection_traits)
计算集合中各特征值的出现频率。
必填: collection_traits
calculate_rarity_score(nft_traits, collection_traits)
计算单个 NFT 的稀有度评分。
必填: nft_traits, collection_traits
rank_rarity(target_traits, collection_traits)
在集合内对目标 NFT 进行稀有度排名。
必填: target_traits, collection_traits
analyze_floor_price(current_floor, historical_floors, period=30)
分析地板价趋势。
必填: current_floor, historical_floors
comparable_sales_valuation(target_traits, comparable_sales, floor_price, market_sentiment=1.0)
可比销售法估值。
必填: target_traits, comparable_sales, floor_price
value_nft(target_traits, collection_traits, floor_price, historical_floors=None, comparable_sales=None, market_sentiment=1.0)
NFT 综合估值。
必填: target_traits, collection_traits, floor_price
调用示例
python scripts/main.py \
--current-floor <current_floor> \
--historical-floors <historical_floors> \
--period <period> \
