Nft Floor X402

NFT フロア価格・レアリティ API

NFT コレクションのフロア価格、取引量、保有者、レアリティのデータを取得できます。Alchemy 経由で Ethereum と Base に対応しています。x402 を介した従量課金（Base L2 上の USDC）で、API キーや登録は不要です。レート制限もありません。

klymax402 マーケットプレイスの一部です。AI エージェント向けの x402 マイクロペイメント API を 100 個提供し、Base 上の USDC を 1 つのウォレットで利用できます。

クイックスタート -- 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 コレクションのフロア価格、取引量、保有者データが必要な場合に使用します。Ethereum と Base の NFT について、Alchemy から包括的なコレクション統計情報を取得します。

パラメーター

名前	型	必須	説明
address	string	はい	NFT コレクションのコントラクトアドレス。例：0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D（BAYC）
chain	string	いいえ	ブロックチェーン：ethereum または base。デフォルト：ethereum

戻り値

• floorPrice -- ETH および USD 建ての現在のフロア価格
• volume24h -- ETH および USD 建ての過去 24 時間の取引量
• 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 コレクションのフロア価格、取引量、保有者データが必要な場合に使用します。Ethereum と Base の NFT について、Alchemy から包括的なコレクション統計情報を取得します。nft_get_collection_data の POST 版です。同じパラメーターをクエリ文字列ではなく JSON ボディで渡します。

パラメーター

名前	型	必須	説明
address	string	はい	NFT コレクションのコントラクトアドレス。例：0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D（BAYC）
chain	string	いいえ	ブロックチェーン：ethereum または base。デフォルト：ethereum

戻り値

• floorPrice -- ETH および USD 建ての現在のフロア価格
• volume24h -- ETH および USD 建ての過去 24 時間の取引量
• 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 の評価、割安なトークンの発見、またはレアリティに基づく取引戦略の構築。

エージェント向けプロンプトの例

• 「NFT コレクションのフロア価格、取引量、または保有者データ」
• 「NFT コレクションのフロア価格、取引量、または保有者データ」
• 「特定の NFT トークンのレアリティデータ」

支払い

• プロトコル：x402 -- HTTP ネイティブの呼び出しごとの従量課金。登録不要、API キー不要
• ネットワーク：Base L2 (eip155:8453)
• アセット：USDC
• ファシリテーター：Coinbase CDP（プライマリ）、PayAI（フォールバック）
• ATXP 経由でも利用可能（OAuth でラップされた x402、RFC 9728 の保護リソースメタデータに対応）

klymax402 の一部

AI エージェント向けの x402 マイクロペイメント API 100 種類。ウォレットは 1 つ、Base 上の USDC を利用し、登録は不要です。

• カタログ：https://klymax402.com/llms.txt
• API リファレンス全文：https://klymax402.com/llms-full.txt
• ライブ統計：https://klymax402.com/stats

ライセンス

MIT