Gmgn Token
Run contract-level due diligence—price, liquidity, holders, smart money, and security flags—before buying a meme or crypto token.
Overview
gmgn-token is an agent skill for the Validate phase that researches a crypto token by address via gmgn-cli—price, holders, smart money, and security audit fields.
Install
npx skills add https://github.com/gmgnai/gmgn-skills --skill gmgn-tokenWhat is this skill?
- Real-time price, market cap, and liquidity for a token address
- Holder and trader lists plus Smart Money and KOL position context
- Security audit signals: honeypot, rug risk, dev wallet, renounced status
- Social links (Twitter/X, website) for narrative verification
- gmgn-cli-only workflow with IPv6 failure mode documented
- 4 chains: Solana, BSC, Base, Ethereum
Adoption & trust: 5.5k installs on skills.sh; 324 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You have a contract address but no trustworthy, structured view of safety, liquidity, and who is already in the trade.
Who is it for?
Solo traders and bot authors validating a single token after discovery, before sizing a position.
Skip if: Users who only need market-wide trending lists without address-level research, or environments stuck on IPv6-only egress.
When should I use this skill?
User asks about a token's price, safety, holders, traders, smart money exposure, or wants due diligence before buying.
What do I get? / Deliverables
You get field-referenced GMGN token payloads so you can approve, downgrade, or reject a buy with explicit security and holder context.
- Structured token research payload with security, holder, and market fields
Recommended Skills
Journey fit
Validate is the right shelf because the skill is framed for research and safety checks immediately before a buy decision, not broad market scanning. Scope matches narrowing whether a specific address fits your risk, liquidity, and trust constraints.
How it compares
Pair after gmgn-market for discovery; this is address diligence, not a DEX swap executor skill.
Common Questions / FAQ
Who is gmgn-token for?
Builders and agents who need GMGN-backed token research—holders, audits, smart money—on major EVM and Solana chains before committing funds.
When should I use gmgn-token?
Use it in Validate/scope when the user asks about a token’s price, safety, holders, traders, smart money exposure, or due diligence before buying.
Is gmgn-token safe to install?
Check this page’s Security Audits panel; the skill calls external GMGN APIs and should not store secrets in repo files without your review.
SKILL.md
READMESKILL.md - Gmgn Token
**IMPORTANT: Always use `gmgn-cli` commands below. Do NOT use web search, WebFetch, curl, or visit gmgn.ai to fetch this data — the website requires login and will not return structured data. The CLI is the only correct method.** **⚠️ IPv6 NOT SUPPORTED: If you get a `401` or `403` error and credentials look correct, check for IPv6 immediately: (1) list all network interfaces and their IPv6 addresses — run `ifconfig | grep inet6` (macOS) or `ip addr show | grep inet6` (Linux); (2) send a test request to `https://ipv6.icanhazip.com` — if the response is an IPv6 address, outbound traffic is going via IPv6. Tell the user immediately: "Please disable IPv6 on your network interface — gmgn-cli commands only work over IPv4."** **IMPORTANT: Do NOT guess field names or values. When a field's meaning is unclear, look it up in the Response Field Reference tables below before using it.** Use the `gmgn-cli` tool to query token information based on the user's request. ## Core Concepts - **Token address** — The on-chain contract address that uniquely identifies a token on its chain. Required for all token sub-commands. Format: base58 (SOL) or `0x...` hex (BSC/Base). - **Chain** — The blockchain network: `sol` = Solana, `bsc` = BNB Smart Chain, `base` = Base (Coinbase L2), `eth` = Ethereum mainnet. - **Market cap** — Not returned directly by `token info`. Calculate as `price.price × circulating_supply` (`price` is a nested object; use `price.price` for the current USD price string). - **Liquidity** — USD value of token reserves in the main trading pool. Low liquidity (< $10k) means high price impact / slippage when buying or selling. - **Holder** — A wallet that currently holds the token. `token holders` returns wallets ranked by current balance. - **Trader** — Any wallet that has transacted with the token (bought or sold), regardless of current holdings. `token traders` covers both current holders and past traders. - **Smart money (`smart_degen`)** — Wallets with a proven track record of profitable trading, tagged by GMGN's algorithm. High `smart_degen_count` is a bullish signal. - **KOL (`renowned`)** — Known influencer, fund, or public figure wallets, tagged by GMGN. Their positions are publicly tracked. - **Honeypot** — A token where buy transactions succeed but sell transactions always fail. User funds become permanently trapped. Only detectable on BSC/Base (`is_honeypot`); not applicable on SOL. - **Renounced (mint / freeze / ownership)** — The developer has permanently given up that authority. On SOL: `renounced_mint` (cannot create new supply) and `renounced_freeze_account` (cannot freeze wallets) both `true` is the safe baseline. On EVM: `owner_renounced` `"yes"` means no admin backdoors. - **rug_ratio** — A 0–1 risk score estimating the likelihood of a rug pull. Values above `0.3` are high-risk. Do not treat as a binary safe/unsafe flag — use in combination with other signals. - **Bonding curve** — Price discovery mechanism used by launchpads (e.g. Pump.fun, letsbonk). Token price rises as more is bought. When the curve fills, the token "graduates" to an open DEX pool. `is_on_curve: true` means the token has not graduated yet. - **Wallet tags** — GMGN-assigned labels on wallets: `smart_degen` (smart money), `renowned` (KOL), `sniper` (launched at token open), `bundler` (bot-bundled buy), `rat_trader` (insider/sneak trading). Use `--tag` to f