Name: gmgn-holder-analysis
Author: bencarson001

Imported from bencarson001/AI-MEME-COIN-FINAL (agent/skills/gmgn-holder-analysis/SKILL.md). Install upstream with npx skills add bencarson001/AI-MEME-COIN-FINAL --skill gmgn-holder-analysis. Copyright stays with the author.

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:

python3 ~/.claude/skills/gmgn-holder-analysis/analyze.py <FILL_IN_TOKEN_ADDRESS> <FILL_IN_CHAIN> <FILL_IN_LANG>

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

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 %.
`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
`buy_tx_count_cur`	int	Buy transactions since token creation
`sell_tx_count_cur`	int	Sell transactions since token creation
`sell_amount_percentage`	float	Fraction of total buys that have been sold
`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`, `fomo`, `kol`
`native_balance`	string	Raw native token balance (SOL: lamports /1e9; EVM: wei /1e18)
`native_transfer`	object	`{from_address, amount, timestamp}` — how wallet was funded
`twitter_name`	string	Twitter handle if known
`exchange`	string	DEX name for pool wallets

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[].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

Rating Standard

Entry timing pressure (批次浮盈/出货) does NOT affect the overall rating — it only affects section display.

Rating (ZH)	Rating (EN)	Emoji	Condition
不建议买	Not Recommended	🔴	Any: rat traders >10% / largest wallet >15% / dev sock puppet
谨慎参与	Caution	⚠️	≥2 of: Dev still holding / airdrop >15% / risk wallets >30% / linked >10%
可轻仓	Light Position	🟡	Exactly 1 of above warns
正常参与	Normal	✅	None of the above

Supported Chains

sol, bsc, base, eth, robinhood, arc, stable

Notes

balance >= 1 threshold avoids dust false positives when identifying dev holdings
SOL native_balance is in lamports (÷1e9); EVM native_balance is in wei (÷1e18)
total_supply is estimated as the median of balance / amount_percentage across normal wallets
cur_price is estimated as the median of usd_value / balance across normal wallets
Top5 displays Twitter name when available; else first4...last4 format

{ "ocm": "1", "id": "bencarson001-ai-meme-coin-final-gmgn-holder-analysis", "kind": "skill", "name": "gmgn-holder-analysis", "description": "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 analysis, 筹码分析, 持仓分析, chip structure, who is holding, or whether a token is safe to buy based on its holder composition.", "publisher": "bencarson001", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "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 analysis, 筹码分析, 持仓分析, chip structure, who is holding, or whether a token is safe to buy based on its holder composition." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/bencarson001/AI-MEME-COIN-FINAL", "path": "agent/skills/gmgn-holder-analysis/SKILL.md", "ref": "221c8a1ecc284075cc1dc5188d71528901020ba6", "url": "https://github.com/bencarson001/AI-MEME-COIN-FINAL/blob/221c8a1ecc284075cc1dc5188d71528901020ba6/agent/skills/gmgn-holder-analysis/SKILL.md", "key": "bencarson001/AI-MEME-COIN-FINAL/agent/skills/gmgn-holder-analysis/SKILL.md" } }, "instructions": "**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`.**\n\n**IMPORTANT: Always use `gmgn-cli` commands. Do NOT use curl, WebFetch, or visit gmgn.ai.**\n\nWhen 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, `'e", "cost": { "context_tokens": 10642 } }

gmgn-holder-analysis

About

Analysis Script

Output Rule

Field Reference

Holder object key fields

Created-tokens response fields

Rating Standard

Supported Chains

Notes

Use it

Manifest

Reviews