Holder Concentration

Analyze token holder distribution and concentration metrics on the Base blockchain.

Updated Jun 17, 2026
One-click install
npx skills add https://github.com/aeoncity-demo/myaeon --skill holder-concentration-aeoncity-demo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Holder Concentration
Source: https://github.com/aeoncity-demo/myaeon/tree/main/skills/holder-concentration
Command: npx skills add https://github.com/aeoncity-demo/myaeon --skill holder-concentration-aeoncity-demo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ETHERSCAN_API_KEY, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides detailed analysis of token holder distribution on the Base blockchain, helping users understand the concentration of token supply and identify potential security risks.

Core Features & Use Cases

  • Token Holder Distribution Analysis: Analyze top-N share, Herfindahl-Hirschman Index (HHI) concentration, and identify LP/lock/burn exclusions and whale clusters.
  • Security Insights: Assess the potential risks of token concentration and provide insights into the security of the token on-chain.
  • Use Case: For a DeFi project, this Skill can help analyze the token distribution of a liquidity pool and identify potential risks due to excessive concentration of wealth.

Quick Start

Run the Holder Concentration Skill with the token contract address as input.

Frequently Asked Questions about Holder Concentration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze token holder distribution on the Base blockchain?

Analyzing token holder distribution on the Base blockchain requires a token contract address to calculate top-N share, Herfindahl-Hirschman Index (HHI) concentration, and identify whale clusters.

What is token concentration and how does it indicate on-chain security risks?

Token concentration measures supply distribution across holders using metrics like HHI. High concentration indicates whale clusters control significant supply, presenting potential on-chain security risks for DeFi projects.

Do I need an Etherscan API key to check Base token holdership concentration?

Yes, checking Base token holdership concentration requires an ETHERSCAN_API_KEY to access Etherscan v2, alongside Base RPC connectivity, for retrieving the necessary on-chain holder data.

Can I exclude liquidity pool, lock, and burn addresses from holder distribution analysis?

Yes, holder distribution analysis identifies LP, lock, and burn exclusions, ensuring whale cluster identification and concentration metrics accurately reflect active market participants.

What is the best way to identify whale clusters in a Base token supply?

The best way to identify whale clusters in a Base token supply is by analyzing top-N share and HHI concentration metrics, which highlight addresses holding disproportionate amounts of tokens.

Why does high token concentration pose risks for DeFi liquidity pools?

High token concentration poses risks for DeFi liquidity pools because whale clusters holding excessive wealth can manipulate market prices or drain liquidity, undermining on-chain security.

Related Skills