English Français العربية

Token Holders API

Official registry Other

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (sse)
Claude Code 
claude mcp add --transport sse token-holders-api 'https://token-holders.api.klymax402.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "token-holders-api": {
            "type": "sse",
            "url": "https://token-holders.api.klymax402.com/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Token Holders API
  2. Quickstart -- MCP
  3. Quickstart -- HTTP (x402)
  4. Tools
  5. Example agent prompts
  6. Payment
  7. Part of klymax402
  8. License

Token Holders API

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.):

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

Quickstart -- 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

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:

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

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

Frequently asked questions

What is Token Holders API?

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

How do I install Token Holders API?

It runs as a remote server. In Claude Code: claude mcp add --transport sse token-holders-api 'https://token-holders.api.klymax402.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Token Holders API need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Token Holders API open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Token Holders API?

It is published by Br0ski777. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.