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 分