Nft Floor X402

NFT 地板价和稀有度 API

NFT 系列地板价、交易量、持有者和稀有度数据。通过 Alchemy 支持 Ethereum 和 Base。通过 x402 按调用付费（Base L2 上的 USDC）——无需 API 密钥、无需注册，也没有速率限制。

这是 klymax402 市场的一部分——面向 AI Agent 的 100 个 x402 微支付 API，只需一个钱包，即可使用 Base 上的 USDC。

快速开始 -- MCP

添加到 MCP 客户端配置中（Claude Desktop、Cursor、ElizaOS 等）：

{
  "mcpServers": {
    "nft-floor": {
      "url": "https://nft-floor.api.klymax402.com/mcp"
    }
  }
}

快速开始 -- HTTP（x402）

curl "https://nft-floor.api.klymax402.com/api/collection?address=0x0000000000000000000000000000000000dEaD"
# -> 402 Payment Required, with an x402 payment challenge in the response body

任何支持 x402 的客户端（@x402/fetch、x402-agent-tools、ATXP）都会自动处理 402 -> 签名 -> 重试流程。

工具

工具	方法	路径	价格	描述
nft_get_collection_data	GET	/api/collection	$0.012	获取 NFT 系列地板价、交易量和统计数据
nft_get_collection_data	POST	/api/collection	$0.012	获取 NFT 系列地板价、交易量和统计数据（POST 变体）
nft_get_token_rarity	GET	/api/rarity	$0.008	获取 NFT 代币稀有度排名、评分和特征地板价
nft_get_token_rarity	POST	/api/rarity	$0.008	获取 NFT 代币稀有度排名、评分和特征地板价（POST 变体）

nft_get_collection_data

需要 NFT 系列地板价、交易量或持有者数据时使用。返回由 Alchemy 提供的 Ethereum 和 Base NFT 系列综合统计数据。

参数

名称	类型	必填	描述
address	string	是	NFT 系列合约地址。例如：0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D（BAYC）
chain	string	否	区块链：ethereum 或 base。默认值：ethereum

返回值

• floorPrice -- 当前地板价，单位为 ETH 和 USD
• volume24h -- 24 小时交易量，单位为 ETH 和 USD
• totalSupply -- 系列中的 NFT 总数
• holderCount -- 唯一持有者数量
• listedCount -- 当前挂牌出售的 NFT 数量
• listedPercent -- 已挂牌供应量的百分比
• topTraitFloors -- 按主要特征细分的地板价

响应示例：

{"floorPrice":{"eth":12.5,"usd":44000},"volume24h":{"eth":89.3,"usd":314000},"totalSupply":10000,"holderCount":5421,"listedCount":312,"listedPercent":3.12,"topTraitFloors":[{"trait":"Gold Fur","floor":45.2}]}

适用场景：追踪 NFT 系列价值、比较不同系列或监控地板价变动。对于 NFT 投资组合估值和市场分析至关重要。

nft_get_collection_data

需要 NFT 系列地板价、交易量或持有者数据时使用。返回由 Alchemy 提供的 Ethereum 和 Base NFT 系列综合统计数据。nft_get_collection_data 的 POST 变体——参数以 JSON 请求体而非查询字符串传递。

参数

名称	类型	必填	描述
address	string	是	NFT 系列合约地址。例如：0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D（BAYC）
chain	string	否	区块链：ethereum 或 base。默认值：ethereum

返回值

• floorPrice -- 当前地板价，单位为 ETH 和 USD
• volume24h -- 24 小时交易量，单位为 ETH 和 USD
• totalSupply -- 系列中的 NFT 总数
• holderCount -- 唯一持有者数量
• listedCount -- 当前挂牌出售的 NFT 数量
• listedPercent -- 已挂牌供应量的百分比
• topTraitFloors -- 按主要特征细分的地板价

响应示例：

{"floorPrice":{"eth":12.5,"usd":44000},"volume24h":{"eth":89.3,"usd":314000},"totalSupply":10000,"holderCount":5421,"listedCount":312,"listedPercent":3.12,"topTraitFloors":[{"trait":"Gold Fur","floor":45.2}]}

适用场景：追踪 NFT 系列价值、比较不同系列或监控地板价变动。对于 NFT 投资组合估值和市场分析至关重要。

nft_get_token_rarity

当你需要特定 NFT 代币的稀有度数据时使用。返回稀有度排名、评分、属性以及用于估值的特征级地板价。

参数

名称	类型	必填	描述
address	string	是	NFT 集合合约地址
tokenId	string	是	集合中的代币 ID。例如：1234
chain	string	否	区块链：ethereum 或 base。默认值：ethereum

返回值

• rarityRank -- 代币在集合中的稀有度排名（例如：在 10000 个代币中排名第 142）
• rarityScore -- 计算得出的稀有度评分
• totalSupply -- 集合中的代币总数
• attributes -- 代币特征数组，包含名称、值、频率和特征地板价
• estimatedValue -- 根据稀有度和特征地板价估算的价值

响应示例：

{"rarityRank":142,"rarityScore":285.4,"totalSupply":10000,"attributes":[{"trait":"Background","value":"Gold","frequency":0.02,"traitFloor":18.5},{"trait":"Eyes","value":"Laser","frequency":0.04,"traitFloor":15.2}],"estimatedValue":{"eth":22.3,"usd":78500}}

适用场景：评估单个 NFT 的价值、寻找定价偏低的代币，或构建基于稀有度的交易策略。

nft_get_token_rarity

当你需要特定 NFT 代币的稀有度数据时使用。返回稀有度排名、评分、属性以及用于估值的特征级地板价。nft_get_token_rarity 的 POST 变体——相同参数以 JSON 请求体传递，而非查询字符串。

参数

名称	类型	必填	描述
address	string	是	NFT 集合合约地址
tokenId	string	是	集合中的代币 ID。例如：1234
chain	string	否	区块链：ethereum 或 base。默认值：ethereum

返回值

• rarityRank -- 代币在集合中的稀有度排名（例如：在 10000 个代币中排名第 142）
• rarityScore -- 计算得出的稀有度评分
• totalSupply -- 集合中的代币总数
• attributes -- 代币特征数组，包含名称、值、频率和特征地板价
• estimatedValue -- 根据稀有度和特征地板价估算的价值

响应示例：

{"rarityRank":142,"rarityScore":285.4,"totalSupply":10000,"attributes":[{"trait":"Background","value":"Gold","frequency":0.02,"traitFloor":18.5},{"trait":"Eyes","value":"Laser","frequency":0.04,"traitFloor":15.2}],"estimatedValue":{"eth":22.3,"usd":78500}}

适用场景：评估单个 NFT 的价值、寻找定价偏低的代币，或构建基于稀有度的交易策略。

Agent 提示词示例

• “NFT 集合的地板价、交易量或持有者数据”
• “NFT 集合的地板价、交易量或持有者数据”
• “特定 NFT 代币的稀有度数据”

付款

• 协议：x402 -- 基于 HTTP 的按次付费，无需注册或 API 密钥
• 网络：Base L2（eip155:8453）
• 资产：USDC
• Facilitator：Coinbase CDP（主要），PayAI（备用）
• 也可通过 ATXP 使用（采用 OAuth 封装的 x402，受 RFC 9728 保护的资源元数据）

klymax402 项目的一部分

为 AI Agent 提供的 100 个 x402 微支付 API——一个钱包、Base 上的 USDC、无需注册。

• 目录：https://klymax402.com/llms.txt
• 完整 API 参考：https://klymax402.com/llms-full.txt
• 实时统计：https://klymax402.com/stats

许可证

MIT