Holder concentration analysis using Gini, HHI, Nakamoto, and top-10 metrics.
GET /dex-metrics/v1/{network}/{token_address}/distributionReturns statistical measures of how concentrated or distributed a token's holders are. These are the same metrics used in academic finance to measure market concentration.
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
network | path | string | Yes | Network ID (see Supported Networks) |
token_address | path | string | Yes | Token contract address |
Example Request
curl -H "X-API-Key: YOUR_API_KEY" \
https://api.insightx.network/dex-metrics/v1/sol/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/distributionResponse
{
"gini": 0.72,
"hhi": 0.15,
"nakamoto": 3,
"top_10_holder_concentration": 65.3
}Fields
| Field | Type | Description |
|---|---|---|
gini | number | Gini coefficient (0 to 1). Measures inequality of holder distribution. 0 = every holder has the same amount, 1 = one holder has everything. |
hhi | number | Herfindahl-Hirschman Index (0 to 1). Measures concentration. Higher values mean fewer entities control more supply. |
nakamoto | integer | Nakamoto coefficient. The minimum number of holders needed to control more than 50% of supply. Lower = more concentrated. |
top_10_holder_concentration | number | Percentage of total supply held by the top 10 holders (excluding known liquidity pools). |
How to Interpret
Gini Coefficient
The Gini coefficient measures inequality. In the context of token holders, it tells you whether supply is evenly spread or concentrated in a few wallets.
| Gini | Interpretation |
|---|---|
| < 0.4 | Relatively equal distribution -- supply is spread across many holders |
| 0.4 - 0.7 | Moderate concentration -- some wallets hold disproportionately more |
| > 0.7 | Highly concentrated -- a few wallets dominate supply |
Most tokens in the wild have Gini values above 0.8. A "healthy" value depends heavily on the token's age and market cap.
Herfindahl-Hirschman Index (HHI)
HHI squares each holder's share and sums the results. It is more sensitive to large holders than Gini.
| HHI | Interpretation |
|---|---|
| < 0.01 | Highly competitive / well distributed |
| 0.01 - 0.15 | Moderate concentration |
| > 0.15 | High concentration |
Nakamoto Coefficient
The smallest number of holders whose combined supply exceeds 50%. A lower number means more centralized control.
| Nakamoto | Interpretation |
|---|---|
| 1-2 | Extremely concentrated -- one or two entities control majority |
| 3-10 | Moderately concentrated |
| > 10 | Well distributed |
Top 10 Holder Concentration
The percentage of total supply held by the 10 largest holders (excluding known liquidity pools). A quick gauge of how much power the biggest holders have.
Use Cases
- Risk screening -- flag tokens where Nakamoto is 1-2 or Gini exceeds 0.9 as high-risk due to potential rug-pull scenarios.
- Portfolio filtering -- only invest in tokens with a minimum Nakamoto of 5 or top-10 concentration below 50%.
- Dashboard widgets -- display distribution health alongside price data.
- Comparative analysis -- compare distribution metrics across tokens in the same sector.
Network Support
| Network | Status |
|---|---|
Solana (sol) | Supported |
Ethereum (eth) | Supported |
Base (base) | Supported |
BNB Smart Chain (bsc) | Supported |
Sui (sui) | Supported |