Skip to main content
GET
/
rwa
/
hci
List Holder Concentration Index
curl --request GET \
  --url https://api.webacy.com/rwa/hci \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "chain": "eth",
      "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "symbol": "USDC",
      "name": "USD Coin",
      "holderConcentration": {
        "top10": {
          "index": 0.421,
          "topSharePct": 62.3,
          "riskBand": "high"
        },
        "top30": {
          "index": 0.612,
          "topSharePct": 78.5,
          "riskBand": "extreme"
        },
        "holderCount": 2341847
      }
    },
    {
      "chain": "eth",
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "symbol": "USDT",
      "name": "Tether USD",
      "holderConcentration": {
        "top10": {
          "index": 0.183,
          "topSharePct": 41.7,
          "riskBand": "low"
        },
        "top30": {
          "index": 0.241,
          "topSharePct": 55.2,
          "riskBand": "medium"
        },
        "holderCount": 5892341
      }
    }
  ],
  "meta": {
    "generatedAt": "2026-04-24T03:00:00Z",
    "stale": false,
    "page": 1,
    "pageSize": 50,
    "total": 749,
    "totalPages": 15,
    "totalUnfiltered": 749,
    "byRiskBand": {
      "low": 312,
      "medium": 187,
      "high": 198,
      "extreme": 52
    },
    "riskBandThresholds": {
      "low": [
        0,
        0.2
      ],
      "medium": [
        0.2,
        0.4
      ],
      "high": [
        0.4,
        0.6
      ],
      "extreme": [
        0.6,
        1
      ]
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.webacy.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
chain
string

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

​
riskBand
enum<string>

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.

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.

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

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

Required range: 1 <= x <= 500

Response

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