> For the complete documentation index, see [llms.txt](https://docs.blockchainsecurity.asia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockchainsecurity.asia/api-reference/readme/on-chain-data/dai-bi-chi-you-ji-zhong-du.md).

# 代幣持有集中度

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

## GET /v1/token/concentration

>

```json
{"openapi":"3.1.0","info":{"title":"Blockchain Atlantis API Gateway","version":"0.1.0"},"tags":[{"description":"取得指定代幣的持有集中度指標，包括前 10、100、1000 名占比，以及 HHI、Gini 等統計值。適合判斷籌碼是否集中。","name":"代幣持有集中度"}],"servers":[{"description":"Production","url":"https://api.blockchainsecurity.asia"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"in":"header","name":"X-API-Key","type":"apiKey"}},"schemas":{"ConcentrationMetrics":{"description":"集中度指標。effective_holders_* 依鏈不同:\n  stables (USDT/USDC/DAI) — `effective_holders_1usd` / `_100usd`\n  bitcoin               — `effective_holders_0_001_btc` / `_0_1_btc`\n                           (BTC/USD 變動快,改用 BTC 計價門檻)\n  其他 token              — 不附","properties":{"effective_holders_0_001_btc":{"description":"餘額 ≥ 0.001 BTC 的地址數（僅 bitcoin）。","format":"int64","minimum":0,"type":["integer","null"]},"effective_holders_0_1_btc":{"description":"餘額 ≥ 0.1 BTC 的地址數（僅 bitcoin）。","format":"int64","minimum":0,"type":["integer","null"]},"effective_holders_100usd":{"description":"餘額 ≥ $100 的地址數（僅穩定幣）。","format":"int64","minimum":0,"type":["integer","null"]},"effective_holders_1usd":{"description":"餘額 ≥ $1 的地址數（僅穩定幣，其他 token 不附）。","format":"int64","minimum":0,"type":["integer","null"]},"gini":{"description":"Gini coefficient（區塊鏈持有結構天然接近 1，僅供相對比較）。","format":"double","type":"number"},"hhi":{"description":"Herfindahl-Hirschman Index（0=完全分散，1=完全壟斷）。","format":"double","type":"number"},"top1000_pct":{"format":"double","type":"number"},"top100_pct":{"format":"double","type":"number"},"top10_pct":{"description":"前 10 名持有者占流通量 %。","format":"double","type":"number"}},"required":["top10_pct","top100_pct","top1000_pct","hhi","gini"],"type":"object"},"QueryMeta":{"description":"查詢層級的中繼資訊。","properties":{"cached":{"description":"是否命中快取（true = 快取結果，回應較快）。","type":"boolean"},"cost_class":{"description":"`light` / `medium` / `heavy`。可依此值決定 retry / backoff 策略。","type":"string"},"limit":{"description":"holders 才有：請求的 limit。","format":"int32","minimum":0,"type":["integer","null"]},"offset":{"description":"holders 才有：請求的 offset。","format":"int32","minimum":0,"type":["integer","null"]},"query_duration_ms":{"description":"本次查詢耗時（毫秒）。","format":"int64","minimum":0,"type":"integer"}},"required":["query_duration_ms","cost_class","cached"],"type":"object"},"Meta":{"description":"回應的中繼資訊。所有欄位都是 `Option`，沒有的就不會出現在 JSON 裡\n（搭配 `skip_serializing_if`），維持輸出乾淨。","properties":{"credit_cost":{"description":"本次請求扣掉的 credit 數量（計費後填入）。","format":"int64","type":["integer","null"]},"credit_remaining":{"description":"本次請求後剩餘的 credit 餘額。","format":"int64","type":["integer","null"]},"pagination":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/PaginationMeta","description":"分頁資訊（僅列表型 endpoint 會帶）。"}]},"request_id":{"description":"本次請求的唯一識別碼，與 log / 追蹤系統對應，方便客訴時定位。","type":["string","null"]}},"type":"object"},"PaginationMeta":{"description":"對外的分頁中繼資訊。","properties":{"limit":{"format":"int32","minimum":0,"type":"integer"},"offset":{"format":"int32","minimum":0,"type":"integer"},"total":{"description":"符合條件的總筆數（若下游能提供）。","format":"int64","minimum":0,"type":["integer","null"]}},"required":["limit","offset"],"type":"object"}}},"paths":{"/v1/token/concentration":{"get":{"operationId":"concentration","parameters":[{"description":"鏈名稱（`ethereum` / `tron` / `bitcoin`）。","in":"path","name":"blockchain","required":true,"schema":{"type":"string"}},{"description":"合約地址（ethereum / tron 必填，bitcoin 必須省略）。","in":"path","name":"contract","required":true,"schema":{"type":["string","null"]}}],"responses":{"200":{"content":{"application/json":{"schema":{"description":"統一成功回應信封。\n\n- `data`：實際的業務資料（泛型 `T`，必須可序列化）。\n- `meta`：與這次請求有關的中繼資訊（request id、分頁、credit 用量等）。","properties":{"data":{"description":"代幣持有集中度查詢的回應。","properties":{"blockchain":{"type":"string"},"concentration":{"$ref":"#/components/schemas/ConcentrationMetrics"},"contract":{"type":["string","null"]},"decimals":{"format":"int32","minimum":0,"type":"integer"},"holder_count":{"format":"int64","minimum":0,"type":"integer"},"meta":{"$ref":"#/components/schemas/QueryMeta"},"symbol":{"type":"string"},"total_supply":{"format":"double","type":["number","null"]},"total_supply_raw":{"type":["string","null"]}},"required":["blockchain","symbol","decimals","holder_count","concentration","meta"],"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"type":"object"}}},"description":"查詢成功，回傳持有集中度指標"},"400":{"description":"請求參數有誤，請檢查輸入內容"},"401":{"description":"缺少或無效的 API key"},"402":{"description":"點數餘額不足"},"429":{"description":"請求過於頻繁，請稍後重試"},"502":{"description":"後端服務暫時無法回應，請稍後重試"},"504":{"description":"查詢逾時，請稍後重試"}},"summary":"","tags":["代幣持有集中度"]}}}}
```