代幣持有集中度

取得指定代幣的持有集中度指標，包括前 10、100、1000 名占比，以及 HHI、Gini 等統計值。適合判斷籌碼是否集中。

get

Authorizations

X-API-KeystringRequired

Path parameters

blockchainstringRequired

鏈名稱（ethereum / tron / bitcoin）。

Example: tron

contractstring · nullableRequired

合約地址（ethereum / tron 必填，bitcoin 必須省略）。

Example: TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t

Responses

200

查詢成功，回傳持有集中度指標

application/json

統一成功回應信封。

• data：實際的業務資料（泛型 T，必須可序列化）。
• meta：與這次請求有關的中繼資訊（request id、分頁、credit 用量等）。

400

請求參數有誤，請檢查輸入內容

401

缺少或無效的 API key

402

點數餘額不足

429

請求過於頻繁，請稍後重試

502

後端服務暫時無法回應，請稍後重試

504

查詢逾時，請稍後重試

get/v1/token/concentration

GET /v1/token/concentration HTTP/1.1
Host: api.blockchainsecurity.asia
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "data": {
    "blockchain": "ethereum",
    "concentration": {
      "effective_holders_100usd": 1818505,
      "effective_holders_1usd": 6706993,
      "gini": 0.998402,
      "hhi": 0.049629,
      "top1000_pct": 79.7241,
      "top100_pct": 68.817,
      "top10_pct": 50.2524
    },
    "contract": "0xdac17f958d2ee523a2206206994597c13d831ec7",
    "decimals": 6,
    "holder_count": 15052045,
    "meta": {
      "cached": true,
      "cost_class": "medium",
      "query_duration_ms": 7096
    },
    "symbol": "USDT",
    "total_supply": 97065699801.98984,
    "total_supply_raw": "97065699801989856"
  },
  "meta": {
    "request_id": "1f0149cd-deb4-4884-bb1f-5085e62a4ccd"
  }
}