GET /dex-metrics/v1/{network}/{token_address}/distribution

Returns 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/distribution

Response

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