Token holder chip analysis — deep analysis of holder structure including chip distribution, entry cost, whale/dev/KOL behavior, risk wallets (rat traders, bundlers, snipers), related wallets, smart money signals, and an AI rating based purely on token structure. Use when user asks about holder analy

BEFORE RUNNING ANY COMMAND: Run gmgn cli config check . If exit code is 0, proceed normally. If exit code is 1, run gmgn cli config and show output, then apply the key with gmgn cli config apply <KEY . If unknown option, tell user to run npm install g gmgn cli . IMPORTANT: Always use gmgn cli commands. Do NOT use curl, WebFetch, or visit gmgn.ai. When the user asks to analyze holders for a token, extract chain and address from their message, then run the analysis script below. Also detect the user's language: set LANG to 'zh' if the user wrote in Chinese, 'en' if in English (default 'zh' ). Analysis Script Run the following command, replacing the placeholders with the actual values: FILL IN CHAIN: sol for Solana addresses; for EVM 0x... addresses use auto unless the user explicitly specifies a chain ( bsc / eth / base ) FILL IN LANG: zh if user wrote Chinese, en if English, default zh Output Rule After the script finishes, paste the complete stdout verbatim into your reply — every line, every section, nothing omitted or summarized. Do NOT add any introduction, commentary, or summary before or after the output block. Field Reference All holding percentages the script prints are share of tradeable float ( 1 burn DEX ), not share of total supply. amount percentage from the API is share of total supply; the script re bases it. Because only the top 100 holders are fetched, a float percentage is a floor when those 100 wallets do not cover the whole float ; the footer reports the actual coverage and states which case applies — floors when coverage <99.5%, complete values when the top 100 cover all of it. When burn + DEX leave less than 2% of supply tradeable (typically a launchpad token before migration), the float denominator degenerates: every / float share inflates dust wallets to double digits or 100%. The script detects this, prints a banner with absolute token/USD figures instead, and sets the rating to ⚪ Cannot Assess. The same suppression applies when token holders returns an empty list (token has no active holders left, or upstream stopped indexing it). Every percentage would render 0.00% and every threshold would pass, so the report would otherwise read "✅ Normal — no obvious dump risk". The script prints a no data banner instead, replaces each "none found 🟢" line with ⚪, and rates ⚪ Cannot Assess. "No data" is never reported as "no risk". In both cases no float percentage is printed at all — every one renders as n/a ( 无法评估 ) and every percentage flag renders ⚪. Printing the number with a caveat was not enough: a divide by zero float puts hold 100.00% and hold 0.00% in the same report, and a reader skimming past the banner reads Rat Trader 1 hold 100.00% as a finding. Wallet counts, token amounts, USD values, and market caps still print — they do not pass through float share . Percentages on a total supply basis also still print ( burn , DEX , float share itself, and the chip quality buckets), because those denominators are unaffected. "Zero cost" must be proven, not inferred from a missing buy count buy tx count cur == 0 does not mean the wallet received its chips for free. Measured on musebook (robinhood): 38 wallets read buy tx count cur: 0 and avg cost: null , but 34 of them carry a finite unrealized pnl ratio (+2.7%, +76.5%, +546%) — a ratio that cannot be computed without a cost basis — and 32 carry a fomo frontend tag, 2 a gmgn tag, which is the trace of active trading, the opposite of receiving an airdrop. What is actually missing is buy transaction indexing on that chain, while the PnL fields come from a separate computation and arrive populated. The error was systematic per chain, not per token. Never bought share of supply, same batch: robinhood 27.0% and 41.2%, arc 26.3%, sol 4.8%. The 20% airdrop warn gate therefore fired on essentially every robinhood/arc token and essentially never on a sol token — a difference in index coverage, not in chip structure. Reporting an unpopulated field as a risk conclusion is exactly what this skill forbids. So a wallet counts as zero cost only when no cost evidence exists at all : Wallets with no indexed buy count but a real cost basis are not dropped from the report — they get their own neutral line, 买入未记录 / Buy count unindexed , with their float share. The fact that upstream did not index their buys is true and stays visible; it just does not drive a zero cost gate. The same predicate now governs the 钻石手 / Diamond cohort (its stated rationale is "a wallet that never paid has no cost to hold through", which a proven cost basis satisfies), the 转入筹码未动 / Idle airdrop line (its "zero cost" caption was a false statement for those wallets), and the Top5 sell risk classification (which was labelling a wallet at +6.6x as "zero cost airdrop — can dump anytime"). Known limit: a genuine airdrop wallet whose unrealized pnl is a huge ratio computed against a dust level cost would be missed here. No second ratio threshold is set for it — there is no measured sample to calibrate one on. The token's own contract address is not a holder wallet Upstream returns it as an ordinary wallet — measured on musebook (robinhood): addr type: 0 , 0 buys, 0 sells, 15.01% of total supply, $5.06M, carrying a fresh wallet tag. Left in the wallet cohort it pollutes biggest , Top10/Top20, airdrop, fresh, risk wallets and Top5 at once, and on its own trips the 🔴 danger gate as "largest wallet holds 16.30% — extreme concentration". The largest genuine wallet on that token is 4.10% of supply. Controls on the same batch — JOLLY (robinhood), SI (sol), ARGUS (arc) — carry no such row, so this is a per token upstream classification gap, not a chain convention. So the script partitions it out of normal and reports it on its own line, on a total supply basis ( 合约自持 / Contract self held ), with its own warn gate at 10% of supply. It is not removed from the judgement: contract held supply reaches the market as soon as one release transaction lands, so it stays visible and still counts toward the rating. It is a warn rather than a danger because that release is an observable prior step, unlike a whale who can sell at will — and there is no higher danger tier, because only one sample has been measured and a second threshold off one sample would be a guess. It is deliberately not deducted from the float denominator. Burn is permanent and the DEX pool is the market itself, so neither can dump; self held supply can. Removing it from the denominator would raise every other wallet's percentage on every token carrying this row, manufacturing new false positives while fixing one. The same address is also excluded from the dev sock puppet map: chips sent back to the token contract, or gas paid to it, is not "transferred to an internal wallet". Holder object key fields Field Type Meaning address string Wallet address balance float Current token balance amount percentage float Fraction of total supply (0–1). Multiply by 100 for %. buy tx count cur int Buy transactions since creation. Not indexed on every chain — a 0 here is not proof the wallet never bought. See the cost basis section above. usd value float Current USD value of holdings avg cost float Average buy price per token unrealized pnl float Unrealized PnL ratio (0.5 = +50%) unrealized profit float Unrealized PnL in USD realized profit float Realized PnL in USD profit float Total PnL in USD (realized + unrealized). Also a valid order by field. sell tx count cur int Sell transactions since token creation sell amount percentage float Fraction of total buys that have been sold. Drives the accumulating/distributing verdict. sell volume cur float USD volume sold since token creation sell amount cur float Token amount sold since token creation history transfer out amount float Token amount transferred out (not sold) history transfer out income float USD value of transferred out tokens token transfer out object {address} — recipient of a transfer out. Used to detect dev sock puppets when the recipient is itself in the top 100. native transfer object {from address, amount, timestamp} — how the wallet was funded. Also the fallback sock puppet probe: a top 100 holder whose gas came from the creator. name string Wallet display name if known start holding at int Unix timestamp of first buy addr type int 0=normal wallet, 1=burn/dead, 2=DEX/pool maker token tags list bundler , rat trader , sniper , whale , top holder , transfer in , dev team , creator tags list smart degen , pump smart , renowned , fresh wallet , wash trader , kol native balance string Raw native token balance. May be a decimal string — parse with float , not int . Denominator is known only for sol (1e9) and bsc / eth / base (1e18). native transfer object {from address, amount, timestamp} — how wallet was funded. Drives 关联资金. twitter name string Twitter handle if known Created tokens response fields Field Meaning inner count Unmigrated token count open count Migrated token count tokens[].market cap Current market cap in USD tokens[].symbol Token symbol tokens[].is open true = migrated creator ath info.ath mc All time high MC across all created tokens creator ath info.ath token Token address of the ATH token creator ath info.token symbol Symbol of the ATH token creator ath info.token name Name of the ATH token Rating Standard All thresholds below are share of tradeable float , matching the script. They are not comparable to GMGN's own UI, which reports share of total supply — on a token whose LP holds 56% of supply, the same wallet reads 2.4× higher here. The Advice section prints every triggered reason, not just the first: a ⚠️ Caution rating means two or more warns fired by definition, so printing one left the reader unable to see why the rating was what it was. Entry timing pressure (批次浮盈/出货) does NOT affect the overall rating — it only affects section display. Rating (ZH) Rating (EN) Emoji Condition 无法评估 Cannot Assess ⚪ Tradeable float <2% of supply, or upstream returned zero holders (all percentage rules suppressed; dev sock puppet still escalates to 🔴) 不建议买 Not Recommended 🔴 Any: rat traders 5% / largest wallet 10% / dev sock puppet 谨慎参与 Caution ⚠️ ≥2 of: Dev still holding 1% / airdrop 20% / risk wallets 35% / linked 15% / contract self holds 10% of supply 可轻仓 Light Position 🟡 Exactly 1 of above warns 正常参与 Normal ✅ None of the above Per metric flag thresholds Metric 🔴 🟡 🟢 Top10 concentration 60% 40% ≤40% Top20 concentration 75% 55% ≤55% Airdropped chips (never bought) 25% 10% ≤10% Risk wallets 35% 15% ≤15% Linked funding 25% 10% ≤10% Zero balance wallets — 10% ≤10% Diamond hands invert (more is better) and use their own emoji set: ✅ 60% / 🟡 35% / ⚠️ ≤35%. Diamond hands require a cost basis ( has cost basis , above) — a wallet that never paid has no cost to hold through, so genuinely zero cost recipients are reported separately as "转入筹码未动 / Idle airdrop" rather than being credited as diamond hands. The test is the cost basis, not buy tx count cur 0 : on chains where buy counts are not indexed the latter discards most real diamond hands (measured on JOLLY: 34 → 75 wallets, 21.1% → 55.7% of float). Linked funding is escalated to at least 🟡 whenever any group was funded within 60s, regardless of size — scripted batch funding is a structural signal

gmgn-holder-analysis