ERC-20 Token Holder Distribution Tracker

Returns the top N holders of any Ethereum ERC-20 token, with balance, share %, top-10/top-100 concentration, and total holder count. Powered by Ethplorer's free API — no key required.

---

What It Does

For any ERC-20 contract address you provide, this Actor returns:

• Top N holders (default 50, max 1000) with address, balance, share_pct
• Total holders count
• Top-10 / Top-100 concentration % (how much of supply is held by the largest wallets)
• Total supply (native units)

Useful for whale detection, distribution event verification, pre-trade due diligence, and dilution monitoring.

---

Why This Matters

• Whale concentration shifts predict moves. When top-10 share drops 3% in a day, that's heavy distribution being absorbed by smaller wallets — often after exchange listings or unlocks.
• Pre-trade DD — a "fair launch" memecoin where top-10 hold 60% is a rug-pull risk. Surfaces this in one API call.
• Dilution tracking — for governance tokens, compare top-100 share month over month to spot DAO selling.

---

Input

Field	Type	Default	Description
tokens	array of strings	—	ERC-20 contract addresses (required)
topN	integer	50	Holders per token (5–1000)
minSharePct	number	0	Skip holders below this %
ethplorerApiKey	string (secret)	freekey	Optional paid Ethplorer key for higher limits

Example: PEPE whale watch

{
  "tokens": ["0x6982508145454ce325ddbe47a25d4ec3d2311933"],
  "topN": 100,
  "minSharePct": 0.5
}

Example: Multi-token concentration sweep

{
  "tokens": [
    "0x6982508145454ce325ddbe47a25d4ec3d2311933",
    "0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE",
    "0x4d224452801ACEd8B2F0aebE155379bb5D594381"
  ],
  "topN": 20
}

---

Output

Per holder row:

{
  "token_symbol": "PEPE",
  "token_name": "Pepe",
  "token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
  "rank": 1,
  "holder_address": "0xf977814e90da44bfa03b6295a0616a897441acec",
  "balance": 56116400786424057000000.0,
  "share_pct": 13.34,
  "is_contract": null
}

Plus a per-token SUMMARY:

{
  "token_symbol": "PEPE",
  "total_holders": 555833,
  "top_10_share_pct": 51.42,
  "top_100_share_pct": 73.18,
  "holders_returned": 100
}

---

Pricing

• $0.001 per holder row returned

Examples:

• Top 50 for one token: $0.05
• Top 100 for 5 tokens: $0.50

---

Use Cases

Whale concentration alarm — Run daily for tokens you hold, alert when top_10_share_pct rises >2% day-over-day (= whale accumulation).

Memecoin DD bot — Before any memecoin trade, query holders and reject if top_10_share_pct > 50.

DAO health monitor — Track governance token concentration over time. Healthy DAOs see top-100 share drift down.

---

Data Source

• Ethplorer /getTokenInfo + /getTopTokenHolders — uses the public freekey by default. Pass your own Ethplorer API key for higher rate limits.

---

Limitations

• Ethereum mainnet only.
• Free Ethplorer tier has rate limits — large batches may hit them. Provide your own API key for production scale.
• is_contract is not reliably populated by the free API.

---

Related Actors

• Smart Money Wallet Tracker — Cross-reference top holders against known smart-money wallets.
• Token Unlock Calendar — Detect concentration drops driven by unlocks.
• CEX Reserve Tracker — Top holders are often CEX wallets; CEX Reserve Tracker labels them.

---

---

🎬 Live Sample Run

A real run of this actor with default-ish inputs, executed on 2026-06-10:

Field	Value
Items in dataset	0
Dataset (JSON)	https://api.apify.com/v2/datasets/dgdRRn246q9Ywj2KT/items?clean=1&format=json
Dataset (CSV)	https://api.apify.com/v2/datasets/dgdRRn246q9Ywj2KT/items?clean=1&format=csv
Run summary (KVS)	https://api.apify.com/v2/key-value-stores/ma2DkH7Qy3iuM4vlx/records/SUMMARY
Run details	https://api.apify.com/v2/actor-runs/MJPVPCvl0OapQ7x0p

Try it now: pop any of the dataset URLs in your browser to see live output, or hit the API endpoints from your code.

Want to reproduce? Click Try Actor on the Apify Store page and use the input defaults shown above.

Feedback

Leave a review on Apify Store