Skip to main content
GET
List Holder Concentration Index

Authorizations

x-api-key
string
header
required

Query Parameters

chain
string

Filter by chain slug. Holder data covers eth, arb, base, opt, pol and bsc; other supported chains return an empty list, unrecognized values return 400.

address
string

Comma-separated token addresses to return (max 50). EVM addresses match in any casing; Solana addresses are case-sensitive. Without chain, every chain the address appears on is returned. Returns 400 for a malformed address or more than 50 entries.

symbol
string

Comma-separated tickers (max 50), exact case-insensitive match. Returns every deployment with that ticker, including unrelated tokens that share it; check meta.symbolCollisions and use address to pin a specific token. Combined with address, a row must match both (AND).

riskBand
enum<string>

Filter by the top-10 HCI risk band. Case-sensitive lowercase. Returns 400 for unrecognized or incorrectly-cased values. meta.byRiskBand counts are computed after the chain / minTop10Index filters and before this one.

Available options:
low,
medium,
high,
extreme
minTop10Index
number

Minimum top-10 holder concentration index (0–1). E.g. 0.4 returns high and extreme tokens only. Returns 400 for non-numeric or out-of-range values.

Required range: 0 <= x <= 1
sort
enum<string>
default:top10Index

Field to sort by. Defaults to top10Index.

Available options:
top10Index,
top30Index,
symbol,
chain,
holderCount
order
enum<string>
default:desc

Sort direction. Defaults to desc.

Available options:
asc,
desc
page
integer
default:1

1-indexed page number. Defaults to 1. Values below 1 are treated as 1.

Required range: x >= 1
pageSize
integer
default:50

Number of results per page. Defaults to 50, max 500. Clamped to 1–500.

Required range: 1 <= x <= 500

Response

Paginated HCI list with per-token holderConcentration data and ecosystem-wide meta aggregates

data
object[]
required
meta
object
required