Token Holders X402

Token Holders API

代币持有者分布——头部持有者、集中度百分比、巨鲸数量。面向 Agent 的链上尽职调查。通过 x402 按次付费（Base L2 上的 USDC）——无需 API 密钥、无需注册，也没有速率限制壁垒。

属于 klymax402 市场的一部分——为 AI Agent 提供 100 个 x402 小额支付 API，一个钱包即可使用 Base 上的 USDC。

快速入门——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）。

Agent 提示词示例

• “分析代币持有者分布和集中度风险”
• “分析代币持有者分布和集中度风险”

付款

• 协议：x402——原生 HTTP 按次付费，无需注册，无需 API 密钥
• 网络：Base L2（eip155:8453）
• 资产：USDC
• 支付协调方：Coinbase CDP（主要）、PayAI（备用）

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