NFT Metadata API

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

这是 klymax402 市场的一部分——100 个面向 AI 代理的 x402 微支付 API，一个钱包，USDC 在 Base 上。

快速开始 -- MCP

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

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

Related MCP server: nft-floor

快速开始 -- HTTP (402)

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

当你需要按合约地址和代币 ID 获取特定 NFT 的元数据时，请使用此工具。它以 JSON 格式返回完整的 NFT 详情。

参数

返回值

• name -- NFT 代币名称

• description -- 代币描述文本

• 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 市场代理和收藏集工具至关重要。

不适合：钱包余额查询（请使用 wallet_get_portfolio）、ENS 解析（请使用 crypto_resolve_ens）、代币安全（请使用 token_check_safety）。

示例代理提示词

• "按合约地址和代币 ID 获取特定 NFT 的元数据"

付费方式

• 协议：x402 -- 原生 HTTP 按次付费，无需注册，无需 API 密钥

• 网络：Base L2（eip155:8453）

• 资产：USDC

• 协调方：Coinbase CDP（主要），PayAI（备用）

• 也可通过 ATXP 访问（OAuth 封装的 x402，符合 RFC 9728 受保护资源元数据）

klymax402 的一部分

100 个面向 AI代理的 x402 微支付 API —— 一个钱包，USDC 在 Base 上，零注册。

• 目录：https://klymax402.com/llms.txt

• 完整 API 参考：https://klymax402.com/llms-full.txt

• 实时统计：https://klymax402.com/stats

许可证

MIT