Overview
Use the HCI API to retrieve paginated, daily-updated concentration data for our stablecoin universe. For each token you get how much of its supply is controlled by the top 10 and top 30 holders, classified into risk bands (low / medium / high / extreme).
Pair HCI with the Depeg Monitor to distinguish between tokens that are depegging right now and tokens with structural concentration risk that could trigger a depeg in the future.
Endpoints
List Holder Concentration Index
Paginated list of all tracked tokens with top-10 and top-30 concentration data, risk bands, and ecosystem-wide
byRiskBand aggregatesKey Concepts
The Index vs. Top Share
Each cohort gives you two related but distinct numbers:topSharePct = 80 means the top 10 wallets hold 80% of supply.index = 0.8 would mean the supply is extremely concentrated even within that group — e.g. one wallet holding almost everything. Together, both fields give you the full picture.
Risk Bands
You’ll find the derivation thresholds in every response as
meta.riskBandThresholds.
byRiskBand is pre-filter
meta.byRiskBand counts are computed before the riskBand query filter is applied. This means you always get the full ecosystem distribution regardless of what filter you have active — useful for building risk-breakdown dashboards without making a separate unfiltered request.