• WHALE DETECTION
  • RISK ASSESSMENT
  • CROSS-CHAIN
  • HUMAN REVIEW

How to analyze token holder distribution with your AI

Connect The Graph to your AI client to pull live on-chain data. Once connected, your agent handles the heavy lifting of querying blockchain state for specific addresses.

Ask AI about this page

Short answer

How can I check token holder distribution using AI?

Your AI uses The Graph to fetch holder lists for specific EVM or Solana addresses. It then calculates concentration levels and identifies large whale wallets. You get a clear picture of how much supply is held by top addresses.

The outcomes

What you get from the analysis

The AI turns raw blockchain data into actionable intelligence.

WHALE DETECTION

Identify top holders

The AI pulls the largest wallets from the network. You see exactly which addresses control the most supply.

RISK ASSESSMENT

Spot concentration risks

Your agent calculates the percentage of total supply held by the top wallets. This helps you see if a few people control the market.

CROSS-CHAIN

EVM and Solana coverage

The AI pulls data from both Ethereum-based chains and Solana. You can compare holder patterns across different ecosystems.

HUMAN REVIEW

Manual audit required

The AI flags suspicious clusters or massive dumps. You decide if these movements represent a coordinated attack or organic selling.

The workflow

What your AI does when the request arrives.

The AI acts as an on-chain researcher, moving from raw data retrieval to logical analysis.

  1. Fetch EVM holders

    The AI queries the blockchain to find every wallet holding a specific token on Ethereum or other EVM chains.

    get_evm_holders

  2. Fetch Solana holders

    For Solana-based tokens, the AI pulls the current holder list directly from the network.

    get_svm_holders

  3. Calculate concentration

    The agent processes the list to find the percentage of supply held by the largest wallets.

    get_evm_holdersget_svm_holders

  4. Summarize findings

    The AI presents a clean breakdown of whale wallets and supply distribution.

    get_evm_holdersget_svm_holders

Try it

Copy these to start.

Use these prompts to kick off your analysis.

Starting points

Swap out the placeholder addresses for the actual token or contract addresses you want to audit.

The Graph Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_lKCcPQtDzEbLkEyQdpLNknTGhTDgro8TIiVVYvos/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — The Graph capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "the-graph-web3-indexing-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_lKCcPQtDzEbLkEyQdpLNknTGhTDgro8TIiVVYvos/mcp"
    }
  }
}
Copy into chat04

  • Get the top 50 holders for the Ethereum contract 0x123... and tell me if any single wallet holds more than 5% of the supply.

  • Analyze the holder distribution for this Solana token address ABC... and identify any potential whale clusters.

  • Compare the concentration of the top 10 holders for this EVM token versus this Solana token.

  • List the top 100 holders for 0xabc... and flag any addresses that look like they belong to the same entity.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect The Graph once, then ask.

Just link the MCP to your client. Your credentials stay encrypted, and you can start querying the blockchain immediately.

Connect The Graph to your AI

FAQ

How this task behaves

  • 01

    Can the AI execute trades based on holder data?

    No. The AI can only read holder data through the provided tools. It cannot move funds or interact with smart contracts to trade.

  • 02

    Does the AI work on all blockchains?

    No. It is limited to EVM-compatible networks and Solana via the specific tools provided.

  • 03

    Can the AI delete or modify holder information?

    No. The AI only retrieves data from the blockchain. It has no capability to change on-chain state or modify any records.

  • 04

    How fresh is the holder data?

    The data is pulled directly from the blockchain via The Graph, so it reflects the current state of the network.

  • 05

    Can the AI identify the real-world identity of a whale?

    No. The AI can only see wallet addresses and the amount of tokens they hold. It cannot deanonymize users.

  • More questions about The Graph? The Connector page answers them. See everything the The Graph Connector can do

Connect The Graph to Claude, Cursor, ChatGPT & more