Token Holders X402

トークン保有者 API

トークン保有者の分布――上位保有者、集中度％、クジラの数を確認できます。エージェント向けのオンチェーンデューデリジェンスです。x402 経由の従量課金（Base L2 上の USDC）に対応しており、API キーや登録は不要で、レート制限もありません。

klymax402 マーケットプレイスの一部です。AI エージェント向けの x402 マイクロペイメント API を 100 種類提供し、Base 上の USDC に対応するウォレットは 1 つです。

クイックスタート -- MCP

MCP クライアントの設定に追加します（Claude Desktop、Cursor、ElizaOS など）。

{
  "mcpServers": {
    "token-holders": {
      "url": "https://token-holders.api.klymax402.com/mcp"
    }
  }
}

クイックスタート -- HTTP（x402）

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

x402 対応のクライアント（@x402/fetch、x402-agent-tools、ATXP）であれば、402 → 署名 → 再試行のサイクルが自動的に処理されます。

ツール

ツール	メソッド	パス	価格	説明
token_get_holder_analysis	GET	/api/holders	$0.012	集中度指標を含むトークン保有者分析を取得します
token_get_holder_analysis	POST	/api/holders	$0.012	集中度指標を含むトークン保有者分析を取得します（POST 版）

token_get_holder_analysis

トークン保有者の分布と集中リスクを分析する場合に使用します。保有者の指標を JSON で返します。

パラメーター

名前	型	必須	説明
address	string	はい	トークンコントラクトのアドレス（0x...）
chain	string	いいえ	チェーン：base、ethereum（デフォルト：ethereum）

戻り値

• topHolders -- アドレス、残高、供給量に占める割合を含む上位 10 人の保有者の配列
• top10Concentration -- 上位 10 ウォレットが保有する総供給量の割合
• whaleCount -- 供給量の 1％超を保有するウォレットの数
• totalHolders -- 保有者のユニーク数の合計
• isConcentrated -- 上位 10 ウォレットが供給量の 50％超を保有している場合のブール値フラグ（中央集権化リスク）

レスポンス例：

{"topHolders":[{"address":"0xab...cd","balance":"1250000","percent":12.5}],"top10Concentration":45.2,"whaleCount":7,"totalHolders":15420,"isConcentrated":false}

使用する場面：トークン購入時に、中央集権化やクジラによる売り抜けのリスクを評価する場合です。オンチェーンデューデリジェンスやトークン調査に不可欠です。

用途外：トークン価格データ（token_get_ohlcv_history を使用）、トークンの安全性（token_check_safety を使用）、流動性の厚み（dex_analyze_orderbook_depth を使用）。

token_get_holder_analysis

トークン保有者の分布と集中リスクを分析する場合に使用します。保有者の指標を JSON で返します。token_get_holder_analysis の POST 版です。同じパラメーターをクエリ文字列ではなく JSON ボディで渡します。

パラメーター

名前	型	必須	説明
address	string	はい	トークンコントラクトのアドレス（0x...）
chain	string	いいえ	チェーン：base、ethereum（デフォルト：ethereum）

戻り値

• topHolders -- アドレス、残高、供給量に占める割合を含む上位 10 人の保有者の配列
• top10Concentration -- 上位 10 ウォレットが保有する総供給量の割合
• whaleCount -- 供給量の 1％超を保有するウォレットの数
• totalHolders -- 保有者のユニーク数の合計
• isConcentrated -- 上位 10 ウォレットが供給量の 50％超を保有している場合のブール値フラグ（中央集権化リスク）

レスポンス例：

{"topHolders":[{"address":"0xab...cd","balance":"1250000","percent":12.5}],"top10Concentration":45.2,"whaleCount":7,"totalHolders":15420,"isConcentrated":false}

使用する場面：トークン購入時に、中央集権化やクジラによる売り抜けのリスクを評価する場合です。オンチェーンデューデリジェンスやトークン調査に不可欠です。

用途外：トークン価格データ（token_get_ohlcv_history を使用）、トークンの安全性（token_check_safety を使用）、流動性の厚み（dex_analyze_orderbook_depth を使用）。

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

• 「トークン保有者の分布と集中リスクを分析してください」
• 「トークン保有者の分布と集中リスクを分析してください」

支払い

• プロトコル：x402 -- HTTP ネイティブの従量課金。登録不要、API キー不要
• ネットワーク：Base L2（eip155:8453）
• アセット：USDC
• 決済仲介：Coinbase CDP（プライマリ）、PayAI（フォールバック）

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