NFT メタデータ API

NFT メタデータ検索 -- コントラクト + トークン ID から名前、画像、属性、コレクション情報を取得します。Ethereum と Base に対応。 x402 による従量課金（Base L2 上の USDC）-- API キー不要、登録不要、レート制限の壁なし。

klymax402 マーケットプレイスの一部 -- AI エージェント向けの 100 の x402 マイクロペイメント API、1 つのウォレット、Base 上の USDC。

クイックスタート -- MCP

MCP クライアント設定（Claude Desktop、Cursor、ElizaOS など）に追加してください:

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

Related MCP server: nft-floor

クイックスタート -- 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

コントラクトアドレスとトークン ID から特定の NFT のメタデータを取得するときに使用します。完全な NFT 詳細情報を JSON で返します。

パラメータ

戻り値

• 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 の一部

AI エージェント向けの 100 の x402 マイクロペイメント API -- 1 つのウォレット、Base 上の USDC、登録不要。

• カタログ: https://lymax402.com/llms.txt

• 完全な API リファレンス: https://klymax402.com/llms-full.txt

• ライブ統計: https://lymax402.com/stats

ライセンス

MIT