Nft Metadata X402

NFT 元数据 API

NFT 元数据查询——通过合约和 Token ID 获取名称、图片、属性及集合信息。支持 Ethereum 和 Base。通过 x402 按次付费（使用 Base L2 上的 USDC）——无需 API 密钥、无需注册，也没有速率限制。

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

快速开始——MCP

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

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

快速开始——HTTP（x402）

curl -X POST "https://nft-metadata.api.klymax402.com/api/metadata" \
  -H "Content-Type: application/json" \
  -d '{"contract":"...","tokenId":"..."}'
# -> 402 Payment Required, with an x402 payment challenge in the response body

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

工具

工具	方法	路径	价格	描述
crypto_get_nft_metadata	POST	/api/metadata	$0.008	从合约和 Token ID 获取 NFT 元数据

crypto_get_nft_metadata

当你需要通过合约地址和 Token ID 获取特定 NFT 的元数据时使用。以 JSON 格式返回完整的 NFT 详情。

参数

名称	类型	必填	描述
contract	string	是	NFT 合约地址（例如 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D）
tokenId	string	是	合约中的 Token ID
chain	string	否	区块链：'ethereum' 或 'base'（默认：ethereum）

返回值

• name——NFT Token 名称
• description——Token 描述文本
• imageUrl——NFT 图片/媒体的 URL
• attributes——包含 trait_type 和 value 的特征对象数组
• collection——集合名称和合约信息
• tokenStandard——ERC-721 或 ERC-1155
• chain——NFT 所在的区块链

响应示例：

{"name":"Bored Ape #1234","description":"A unique digital collectible...","imageUrl":"ipfs://Qm...","attributes":[{"trait_type":"Background","value":"Blue"},{"trait_type":"Fur","value":"Gold"}],"collection":"BoredApeYachtClub","tokenStandard":"ERC-721","chain":"ethereum"}

适用场景：NFT 验证、展示和特征分析。对 NFT 市场 Agent 和集合工具至关重要。

不适用于：钱包余额（使用 wallet_get_portfolio）、ENS 解析（使用 crypto_resolve_ens）、Token 安全检查（使用 token_check_safety）。

Agent 提示词示例

• “通过合约地址和 Token ID 获取特定 NFT 的元数据”

付款

• 协议：x402——基于 HTTP 的原生按次付费，无需注册，无需 API 密钥
• 网络：Base L2（eip155:8453）
• 资产：USDC
• 支付中介：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