Token Holders API

io.github.Br0ski777Published by GitHub account Br0ski777v1.1.0Updated Oct 24, 2026

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

VerifiedSSEWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server that returns token holder distribution data — top holders, concentration percentage and whale count — for a contract address, paid per call.

What you can do
Analyze token holder distribution for a contract address on Base or Ethereum, returning the top 10 holders with balances and supply percentages, top-10 concentration, whale count, total holder count and a concentration flag. The same analysis is offered as a GET and a POST variant with identical parameters.
When to use it
Useful when an assistant needs on-chain due diligence on a token, such as assessing centralization or whale dump risk before buying. It is not intended for price history, token safety checks or liquidity depth.
Requirements
A remote MCP endpoint; no API key or signup. Each call is paid per request in USDC on Base L2 through the x402 protocol, so an x402-capable client and a funded wallet are needed to complete the payment challenge. Network access to the endpoint is required.
Before you install
Every call costs money ($0.012 per request) and is settled in USDC on Base through a wallet, so spending should be capped and reviewed. Payment handling is delegated to an x402 client and a Coinbase CDP or PayAI facilitator, which see the payment flow. The server returns public on-chain holder data only.

Installation

In SourceWeft

  1. Open Token Holders API in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via SSE. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Br0ski777%2Ftoken-holders/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "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

Source: README.md at commit 05e71a6

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declaredRequired10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts