代幣持有人排行

列出指定代幣持有量最高的前 N 個地址，快速查看主要持有人與籌碼分布。

get

Authorizations

X-API-KeystringRequired

Path parameters

blockchainstringRequired

鏈名稱（ethereum / tron / bitcoin）。

Example: ethereum

contractstring · nullableRequired

合約地址:ETH 用 0x 開頭 40 字 hex;TRON 用 Base58Check (T…)。 Bitcoin 必須省略。

Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7

limitinteger · nullableRequired

取前幾名（預設 10，上限 100）。

Example: 10

offsetinteger · nullableRequired

偏移（預設 0）。

Example: 0

Responses

200

查詢成功，回傳代幣持有量排行

application/json

統一成功回應信封。

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

400

請求參數有誤（鏈別不支援或合約位址格式錯誤），請檢查輸入內容

401

缺少或無效的 API key

402

點數餘額不足

429

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

502

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

504

查詢逾時，資料量較大的代幣請稍後重試

get/v1/token/holders

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

{
  "data": {
    "blockchain": "ethereum",
    "contract": "0xdac17f958d2ee523a2206206994597c13d831ec7",
    "decimals": 6,
    "holder_count": 15052187,
    "holders": [
      {
        "address": "0xf977814e90da44bfa03b6295a0616a897441acec",
        "balance": 16900000000,
        "balance_raw": "16900000000000000",
        "balance_usd": 16900000000,
        "pct_of_supply": 17.4109,
        "rank": 1
      },
      {
        "address": "0x47ac0fb4f2d84898e4d9e7b4dab3c24507a6d503",
        "balance": 9184997799.482302,
        "balance_raw": "9184997799482302",
        "balance_usd": 9184997799.482302,
        "pct_of_supply": 9.4627,
        "rank": 2
      }
    ],
    "meta": {
      "cached": false,
      "cost_class": "medium",
      "limit": 2,
      "offset": 0,
      "query_duration_ms": 7005
    },
    "symbol": "USDT",
    "total_supply": 97065699801.98984,
    "total_supply_raw": "97065699801989839"
  },
  "meta": {
    "request_id": "c00377d5-c419-4d0d-a9fa-95018c1f766f"
  }
}