Token Holders API

io.github.Br0ski777由 GitHub 账号 Br0ski777 发布v1.1.0更新于 Oct 24, 2026

Token holder distribution — top holders, whale count, concentration score. x402.

已验证SSE可网页运行金融数据与分析

概览

AI 生成的概览

远程 MCP 服务器，按合约地址返回代币持有者分布数据——前十大持有者、集中度百分比和巨鲸数量，按次付费。

可以做什么
分析 Base 或以太坊上某个合约地址的代币持有者分布，返回前 10 名持有者及其余额和供应占比、前十大集中度、巨鲸数量、持有者总数以及集中度标记。同一分析提供 GET 和 POST 两个参数相同的变体。
适用场景
适合助手对代币做链上尽职调查，例如在买入前评估中心化程度或巨鲸抛售风险。不适用于价格历史、代币安全性检查或流动性深度。
运行要求
远程 MCP 端点，无需 API 密钥或注册。每次调用通过 x402 协议以 Base L2 上的 USDC 按次付费，因此需要支持 x402 的客户端和已充值的钱包来完成支付挑战。需要能访问该端点的网络。
安装前请注意
每次调用都产生费用（每请求 0.012 美元），通过钱包以 Base 上的 USDC 结算，应限制并审查支出。支付流程交由 x402 客户端以及 Coinbase CDP 或 PayAI facilitator 处理，它们会接触支付流程。服务器仅返回公开的链上持有者数据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Token Holders API，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 SSE。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.Br0ski777%2Ftoken-holders/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

Token Holders API

[MCP Server] [x402] [License: MIT]

Token holder distribution -- top holders, concentration %, whale count. On-chain due diligence for agents. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.

Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.

Quickstart -- MCP

Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):

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

Quickstart -- HTTP (x402)

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

Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.

Tools

ToolMethodPathPriceDescription
token_get_holder_analysisGET/api/holders$0.012Get token holder analysis with concentration metrics
token_get_holder_analysisPOST/api/holders$0.012Get token holder analysis with concentration metrics (POST variant)

token_get_holder_analysis

Use this when you need to analyze token holder distribution and concentration risk. Returns holder metrics in JSON.

Parameters

NameTypeRequiredDescription
addressstringyesToken contract address (0x...)
chainstringnoChain: base, ethereum (default: ethereum)

Returns

  • topHolders -- array of top 10 holders with address, balance, percentage of supply
  • top10Concentration -- percentage of total supply held by top 10 wallets
  • whaleCount -- number of wallets holding >1% of supply
  • totalHolders -- total unique holder count
  • isConcentrated -- boolean flag if top 10 hold >50% supply (centralization risk)

Example response:

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

When to use: buying a token to assess centralization and whale dump risk. Essential for on-chain due diligence and token research.

Not for: token price data (use token_get_ohlcv_history), token safety (use token_check_safety), liquidity depth (use dex_analyze_orderbook_depth).

token_get_holder_analysis

Use this when you need to analyze token holder distribution and concentration risk. Returns holder metrics in JSON. POST variant of token_get_holder_analysis -- same params passed as JSON body instead of query string.

Parameters

NameTypeRequiredDescription
addressstringyesToken contract address (0x...)
chainstringnoChain: base, ethereum (default: ethereum)

Returns

  • topHolders -- array of top 10 holders with address, balance, percentage of supply
  • top10Concentration -- percentage of total supply held by top 10 wallets
  • whaleCount -- number of wallets holding >1% of supply
  • totalHolders -- total unique holder count
  • isConcentrated -- boolean flag if top 10 hold >50% supply (centralization risk)

Example response:

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

When to use: buying a token to assess centralization and whale dump risk. Essential for on-chain due diligence and token research.

Not for: token price data (use token_get_ohlcv_history), token safety (use token_check_safety), liquidity depth (use dex_analyze_orderbook_depth).

Example agent prompts

  • "Analyze token holder distribution and concentration risk"
  • "Analyze token holder distribution and concentration risk"

Payment

  • Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
  • Network: Base L2 (eip155:8453)
  • Asset: USDC
  • Facilitator: Coinbase CDP (primary), PayAI (fallback)

Part of klymax402

100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.

License

MIT

来源：README.md，提交 05e71a6

工具

0
SourceWeft 尚未读取此服务器的工具。

版本历史

1
  1. v1.1.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式必需10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分