Skip to main content
Glama
Token Holders API

Token Holders API

by Br0ski777

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

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

Related MCP server: address-intel-api

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

Tool

Method

Path

Price

Description

token_get_holder_analysis

GET

/api/holders

$0.012

Get token holder analysis with concentration metrics

token_get_holder_analysis

POST

/api/holders

$0.012

Get 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

Name

Type

Required

Description

address

string

yes

Token contract address (0x...)

chain

string

no

Chain: 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

Name

Type

Required

Description

address

string

yes

Token contract address (0x...)

chain

string

no

Chain: 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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      F
      maintenance
      Provides counterparty risk checks for any EVM address, returning malicious-history flags, tiered risk scoring, and plain-language summaries via x402 payment.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to fetch crypto wallet holdings across chains, including ETH, ERC-20 tokens, and USD values, with pay-per-call access via x402 micropayments.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to access Solana wallet analytics, token data, and DeFi tools via pay-per-request USDC micropayments using the x402 protocol, without API keys or subscriptions.
      13
      61 npm
      MIT