List Holder Concentration Index

get

https://api.webacy.com/rwa/hci

Returns a paginated list of stablecoins and RWA tokens with daily-updated holder concentration data. Each record includes top-10 and top-30 cohort objects with a Herfindahl-style index, linear top-share percentage, and a risk band. meta.byRiskBand counts are computed before the riskBand filter so dashboards always see the full ecosystem distribution. meta.riskBandThresholds documents the band derivation thresholds in-band.

Query Params

chain

string

Filter by chain slug (eth, arb, base, opt, pol, bsc, sol). Returns 400 for unrecognized values.

riskBand

string

enum

Filter by HCI risk band. Case-sensitive lowercase. Returns 400 for unrecognized or incorrectly-cased values. meta.byRiskBand counts are always computed before this filter.

Allowed:

minTop10Index

number

0 to 1

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.

sort

string

enum

Defaults to top10Index

Field to sort by. Defaults to top10Index.

Allowed:

order

string

enum

Defaults to desc

Sort direction. Defaults to desc.

Allowed:

page

integer

≥ 1

Defaults to 1

1-indexed page number. Defaults to 1.

pageSize

integer

1 to 500

Defaults to 50

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

Responses

400

Invalid chain, riskBand, minTop10Index, sort, or order value

503

HCI data temporarily unavailable (S3/cache failure)

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

401Authorization information is missing or invalid