GMGN Token Holders Intelligence — Full Holder List, PnL, Tags, Smart/Sniper/Whale Classification

The deepest on-chain wallet intelligence scraper on Apify. Pass any token (Solana, BSC, Ethereum, Base, Tron, or Monad) and get every holder with 65+ fields per wallet: balance, cost basis, realized / unrealized PnL, buy & sell history, transfer history, GMGN tags (smart, sniper, whale, bundler, fresh, KOL, insider, dev, bluechip), Twitter handle, last-active timestamp, holding period.

One token in, thousands of fully-classified holder records out. The forensics backbone for rugpull research, smart-money tracking, wash-trading detection, and project-level holder analytics.

---

🚀 What this actor does

For each (chain, tokenAddress) you pass, the actor calls GMGN.ai's holders endpoint, paginates through the entire list (up to maxHoldersPerToken), and normalizes each wallet into a stable schema with 65+ fields.

Optionally, it ALSO pulls:

• Holder summary stats — per-token category counts (how many smart_degen, renowned, fresh, insider, dev, bluechip, bundler, sniper, dex_bot wallets hold this token).
• Wallet-tag lists — GMGN's pre-tagged category lists for the token: smart_wallets, sniper_wallets, whale_wallets, fresh_wallets, bundler_wallets, creator_wallets, rat_trader_wallets, renowned_wallets, top_wallets, following_wallets.
• Top buyers — the influential early buyers list with status (hold / sold / bought_more / transfered).

Pass a list of tokens (batch up to 100) and the actor runs all of this in parallel — perfect for analyzing your entire watchlist in one run.

---

💡 Use cases

• Rugpull / forensics research — for any suspect token, get the full holder distribution, suspicious-wallet flags, dev / creator holdings, sniper exposure.
• Token project teams — understand who's holding your token, who's selling, who's whale-watching you. Run daily snapshots for governance & marketing.
• Smart-money tracking dashboards — show "which top wallets hold this token" with their PnL on it.
• Anti-wash-trading — flag isSuspicious wallets and analyze their transfer patterns.
• Insider detection — fresh_wallet + early buy + still-holding = likely insider.
• Pre-pump radar — scan a watchlist of tokens daily; track when smart_degen_count jumps.
• Holder PnL studies — query average cost basis vs current price to gauge if holders are in profit / loss territory (psychology of sell pressure).
• Influencer attribution — find which renowned_wallets / kol wallets quietly bought a token before it pumped.

---

⚙️ Input configuration

Field	Type	Default	Description
tokens	array	required	Array of { chain, address }. Up to 100 entries.
maxHoldersPerToken	integer	500	How many holders to page through per token. Max practical: ~5,000.
holdersOrderBy	string	"amount_percentage"	amount_percentage, balance, realized_profit, profit, buy_amount_cur, sell_amount_cur
direction	string	"desc"	desc or asc.
includeHolderStat	boolean	true	Emit per-token summary row with category counts.
includeWalletTagsStat	boolean	true	Emit one row per (category, wallet) in tagged-wallet lists.
includeTopBuyers	boolean	false	Emit top-buyer status rows.
onlyHolders	boolean	false	Drop rows where balance == 0 (sold out).
tagFilter	string[]	[]	Keep only wallets carrying these GMGN tags.
useProxy	boolean	true	Apify Proxy on/off.
proxyConfiguration	object	residential
maxConcurrency	integer	5

Holder tags GMGN exposes

Tag	Meaning
smart_degen	High-PnL active trader.
renowned	Verified public figure / KOL.
kol	Key opinion leader.
fresh_wallet	Newly-funded wallet (insider signal).
insider	Identified insider wallet.
dev	Project / contract creator.
bluechip	Holds bluechip tokens.
bundler	Bundler wallet (mass-buy bot).
sniper	Sniper bot (block-0 buyer).
whale	Top holder by USD value.
rat_trader	Suspected insider pattern.
dex_bot	Generic DEX bot.
gmgn	Active GMGN user.

---

📦 Output rows

The dataset emits four kinds of rows, distinguished by _kind:

1. holder (per holder row — the bulk of the data)

Field	Description
chain, tokenAddress, walletAddress, rank	Identity.
accountAddress, addrType, exchange, avatar, name, twitterUsername, twitterName	Wallet metadata.
tags, makerTokenTags, walletTagV2	Classification tags.
isNew, isOnCurve, isSuspicious	Boolean flags.
balance, nativeBalance, amountCur, amountPercentage, usdValue, accuAmount, accuCost, sellAmountPercentage	Position size.
cost, costCur, totalCost, avgCost, avgSold	Cost basis.
profit, profitChange, realizedProfit, realizedPnl, unrealizedProfit, unrealizedPnl	PnL.
buyAmountCur, buyTxCountCur, buyVolumeCur	Recent buys.
sellAmountCur, sellTxCountCur, sellVolumeCur	Recent sells.
currentBuyAmount, currentSellAmount, currentTransferInAmount, currentTransferOutAmount	Current-window flows.
historyBoughtCost, historyBoughtFee, historySoldIncome, historySoldFee	Lifetime totals.
historyTransferInAmount, historyTransferInCost, historyTransferOutAmount, historyTransferOutFee, historyTransferOutIncome	Lifetime transfers.
transferIn, transferInCount, transferOutCount, nativeTransfer, tokenTransfer, tokenTransferIn, tokenTransferOut	Transfer counts.
netflowAmount, netflowUsd	Net flow.
createdAt, startHoldingAt, endHoldingAt, lastActiveTimestamp, lastBlock	Timestamps.
gmgnWalletUrl	Convenience link.
scrapedAt	Scrape time.

2. holder_stat (summary row per token)

Field	Description
smartDegenCount	Number of smart_degen holders.
renownedCount	Renowned holders.
freshWalletCount	Fresh wallets.
dexBotCount	DEX bots.
insiderCount	Identified insiders.
followingCount	Holders you (the wallet that ran the call) follow.
devCount	Dev wallets.
bluechipOwnerCount	Bluechip owners.
bundlerCount	Bundlers.
sniperCount	Snipers.

3. wallet_tag_member (one row per wallet in each tagged-category list)

Field	Description
category	One of smart_wallets, sniper_wallets, whale_wallets, fresh_wallets, bundler_wallets, creator_wallets, rat_trader_wallets, renowned_wallets, top_wallets, following_wallets.
walletAddress, tokenAddress, chain	Identity.

4. top_buyer (one row per influential early buyer)

Field	Description
walletAddress, status, tags, makerTokenTags	Wallet + status.
top70SniperHoldRate, boughtRate, holdingRate, top10HolderRate	Token-level header stats included with each row.

---

🧪 Example output (holder row)

{
  "_kind": "holder",
  "chain": "bsc",
  "tokenAddress": "0xe379f34d9405761af8ca8a09fc01d81bb9e74444",
  "rank": 1,
  "walletAddress": "0x1596a456fc3cfbcb24a7de6049d05de44676dfe2",
  "tags": ["gmgn"],
  "makerTokenTags": ["sniper"],
  "isSuspicious": false,
  "balance": 1240000.5,
  "amountPercentage": 0.04938,
  "usdValue": 23801.21,
  "avgCost": 0.0000048,
  "profit": 12450.32,
  "realizedProfit": 8920.12,
  "unrealizedProfit": 3530.2,
  "buyAmountCur": 1240000.5,
  "buyTxCountCur": 4,
  "historyBoughtCost": 5950.24,
  "historySoldIncome": 0,
  "lastActiveTimestamp": "2026-05-15T11:08:00.000Z",
  "gmgnWalletUrl": "https://gmgn.ai/bsc/address/0x1596a456fc3cfbcb24a7de6049d05de44676dfe2",
  "scrapedAt": "2026-05-15T12:00:00.000Z"
}

---

🧰 Recipes

1. Full forensics dump for one token

{
  "tokens": [{ "chain": "sol", "address": "EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm" }],
  "maxHoldersPerToken": 2000,
  "includeHolderStat": true,
  "includeWalletTagsStat": true,
  "includeTopBuyers": true
}

Gets 2,000 holders + summary + tagged-wallet lists + top buyers. ~2,500 rows.

2. Watchlist daily snapshot (10 tokens, 500 holders each)

{
  "tokens": [
    { "chain": "sol", "address": "..." },
    { "chain": "bsc", "address": "..." }
  ],
  "maxHoldersPerToken": 500,
  "includeHolderStat": true
}

Schedule daily → time-series wallet movement archive.

3. Only smart-money + KOL holders

{
  "tokens": [{ "chain": "sol", "address": "..." }],
  "maxHoldersPerToken": 1000,
  "tagFilter": ["smart_degen", "renowned", "kol"]
}

4. Wash-trading flag dataset

{
  "tokens": [...],
  "maxHoldersPerToken": 1000,
  "tagFilter": ["rat_trader", "bundler", "dex_bot"]
}

Surface only the suspicious wallets per token.

5. Profitable holders only (winners club)

Run with holdersOrderBy: "realized_profit" then filter client-side to realizedProfit > 0. Gives you the "who's made money on this token" leaderboard.

---

🛡️ Under the hood

• Endpoints —
  • GET /vas/api/v1/token_holders/{chain}/{addr}?limit=100&cost=20&orderby=...&direction=...&cursor=... (paginated)
  • GET /vas/api/v1/token_holder_stat/{chain}/{addr}
  • GET /api/v1/token_wallet_tags_stat/{chain}/{addr}
  • GET /defi/quotation/v1/tokens/top_buyers/{chain}/{addr}
• Pagination — GMGN's next cursor; the actor follows it until maxHoldersPerToken is hit.
• Auth — none.
• Proxy — Apify Residential default.
• Retries — 5 attempts with exponential backoff on 403 / 429 / 5xx; immediate fail on 404 (missing token).

---

⚡ Performance

Configuration	Rows	Time	Cost
1 token, 500 holders, all extras	~520	<30s	<$0.01
10 tokens, 500 holders each	~5,000	~2 min	~$0.05
100 tokens, 1,000 holders each	~100,000	~20 min	~$0.50

---

📅 Recommended schedules

• Daily watchlist snapshot — once per day for your tracked tokens.
• Live new-token deep dive — on-demand triggered by a launch detector.
• Hourly rugcheck — for active project teams monitoring their own token.

---

❓ FAQ

How many holders can I get per token?

GMGN's paginated holders endpoint practically scales to ~5,000 holders per token. The maxHoldersPerToken input caps it — 500 is the sweet spot for cost vs depth.

Why are some tags empty?

GMGN only assigns tags to wallets it's classified. Most retail wallets are untagged. Tagged wallets are the interesting ones for forensics.

Difference between tags and makerTokenTags?

tags is the wallet's GLOBAL classification (e.g. smart_degen across the whole chain). makerTokenTags is the wallet's role for THIS specific token (e.g. sniper if they bought in block 0).

What's walletTagV2?

GMGN's newer single-label classification (e.g. whale). Often more specific than the tags array.

Why is realizedProfit sometimes negative?

The wallet has sold at a loss. Common for late buyers and panic sellers.

What does isSuspicious: true mean?

GMGN's heuristic for wash trading / suspicious behavior — same wallet on both sides of trades, or bot-like patterns.

Can I get historical holder snapshots?

Not directly — GMGN only exposes current state. To build history, schedule the actor daily and store results timestamped.

How does this interact with the Wallet Portfolio actor?

This actor is token-centric (one token → many wallets). The GMGN Wallet Portfolio & PnL Tracker is wallet-centric (one wallet → many tokens). Use both together for a complete picture.

Are wallet addresses linked to Twitter handles?

When the wallet owner has registered their Twitter on GMGN (or it's been crowd-tagged), twitterUsername / twitterName are populated. About 5-20% of high-PnL wallets are linked.

Can I filter by USD value (whales only)?

Sort by balance or amount_percentage desc to get the biggest wallets first, then take the top N client-side. Or filter the output dataset by usdValue > X.

How fresh is the data?

GMGN's holder list updates every few blocks. The actor returns whatever's current at call time.

What if a token doesn't exist?

The actor logs the error and continues — the rest of the tokens are processed normally.

Why does top_buyers only return ~10-20 wallets?

GMGN's top-buyers endpoint surfaces only wallets that bought significantly early AND are still tracked.

How do I detect insider patterns?

Look for: tags: ["fresh_wallet"] + currentBuyAmount > 0 + realizedProfit > 0. Newly-funded wallet that bought early and is now profitable = strong insider signal.

---

🔗 Related actors

• GMGN Trending Memecoin Scanner — pick which tokens to scrape holders for.
• GMGN New Token Launch Detector — feed fresh token addresses into this actor.
• GMGN Wallet Portfolio & PnL Tracker — wallet-centric view.
• GMGN Smart Money Wallet Leaderboard — top traders.
• GMGN Smart Money Buy Signals — live whale buys.
• GMGN Token Rugcheck & Deep Analytics — security + dev history per token.
• GMGN Crypto KOL Twitter & Telegram Signal Feed — KOL chatter for tokens you're researching.

---

🆘 Support

Bug? Missing tag? Open an issue on the actor's Apify page.