Gmgn Track
Pull real-time smart-money, KOL, and followed-wallet buy/sell activity on Solana, BSC, Base, or Ethereum for copy-trade ideas and whale alerts.
Overview
gmgn-track is an agent skill for the Idea phase that streams smart-money, KOL, and follow-wallet crypto activity via gmgn-cli on Solana, BSC, Base, or Ethereum.
Install
npx skills add https://github.com/gmgnai/gmgn-skills --skill gmgn-trackWhat is this skill?
- gmgn-cli track subcommands for follow-wallet, KOL, and smartmoney flows—never web search or gmgn.ai scrape
- Chains: Solana, BSC, Base, Ethereum with documented response field glossary in SKILL.md
- IPv6 troubleshooting path: 401/403 may require disabling IPv6 for IPv4-only GMGN API
- Pairs with gmgn-portfolio when the user names a specific wallet address
- argument-hint documents chain and optional wallet filter for agent invocations
Adoption & trust: 5k installs on skills.sh; 324 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need structured whale and KOL buy/sell signals but scraping gmgn.ai or guessing API fields returns login walls or wrong trade interpretations.
Who is it for?
Solo traders wiring Claude Code or Cursor to GMGN alpha feeds without manual site login.
Skip if: Full PnL and holdings for one wallet address—use gmgn-portfolio; environments that cannot run gmgn-cli over IPv4.
When should I use this skill?
User asks what smart money or KOLs are buying, wants whale alerts, on-chain alpha, or copy-trade signals on Solana, BSC, Base, or Ethereum—not a single-wallet portfolio deep dive.
What do I get? / Deliverables
You get CLI-backed track results with fields interpreted per SKILL.md, ready to inform watchlists or a follow-up gmgn-portfolio lookup on a specific address.
- Track feed results for follow-wallet, KOL, or smartmoney mode
- Field-accurate interpretation per Response Fields docs
Recommended Skills
Journey fit
Whale and KOL flow is discovery signal before you validate a trade thesis or build automation—first shelf is Idea when hunting on-chain alpha. Discover matches GMGN track feeds for what influential wallets are buying now, distinct from deep portfolio analysis on one address.
How it compares
Use instead of WebFetch on gmgn.ai when the user wants smart money or KOL activity—the website requires login and lacks agent-grade JSON.
Common Questions / FAQ
Who is gmgn-track for?
Indie builders and traders who want GMGN smart-money and KOL activity through gmgn-cli inside coding agents, not through the logged-in web UI.
When should I use gmgn-track?
In Idea discover when the user asks what smart money or KOLs are buying, wants whale alerts, copy-trade memecoin ideas, or follow-wallet flows on sol, bsc, base, or eth.
Is gmgn-track safe to install?
It calls GMGN APIs via CLI; review the Security Audits panel on this page and treat API keys and wallet lists as sensitive configuration.
Workflow Chain
Then invoke: gmgn portfolio
SKILL.md
READMESKILL.md - Gmgn Track
**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.** **IMPORTANT: Do NOT guess field names or values. When a field's meaning is unclear, look it up in the Response Fields sections below before using it.** **⚠️ 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."** Use the `gmgn-cli` tool to query on-chain tracking data based on the user's request. ## Core Concepts - **`follow-wallet` vs `kol` vs `smartmoney`** — Three distinct data sources. `follow-wallet` returns trades from wallets the user has personally followed on the GMGN platform (user-specific; the follow list is resolved from the GMGN user account bound to the API Key). `kol` and `smartmoney` return trades from platform-tagged public wallet lists (not user-specific). Never substitute one for another. - **KOL (Key Opinion Leader)** — Wallets publicly identified as influencers or well-known traders on GMGN. Tagged as `renowned` in the platform's wallet label system. Their trades carry social/marketing signal, not necessarily alpha. - **Smart Money (`smart_degen`)** — Wallets with a statistically proven record of profitable trading, identified by GMGN's algorithm. Same concept as `smart_degen` in gmgn-token. Their trades are a stronger alpha signal than KOL trades. - **`is_open_or_close`** — Indicates whether a trade is a full position event. Interpretation differs by sub-command: - `follow-wallet`: `1` = full position open or close; `0` = partial add or reduce. - `kol` / `smartmoney`: `0` = position opened / added; `1` = position closed / reduced. Do not apply the same interpretation to both sub-commands. - **`price_change`** — Ratio of price change since the trade was made. `6.66` = the token is now 6.66× what it was when the wallet traded (i.e. +566%). `0.5` = price halved since the trade (-50%). Use this to assess "how well did this trade age." - **`base_address` vs `quote_address`** — In a trading pair, `base_address` is the token being bought/sold; `quote_address` is what it was priced in (typically SOL native address on Solana). To get the token of interest, always read `base_address`. - **`maker_info.tags`** — Array of platform labels on the wallet (e.g. `["kol", "gmgn"]`, `["smart_degen", "photon"]`). A wallet can carry multiple tags. Use `tag_rank` (follow-wallet only) to see the wallet's rank within each tag category. - **Cluster signal** — When multiple followed/tracked wallets trade the same token in the same direction within a short time window, this is a stronger conviction signal than a single wallet. Highlight this pattern when it appears in results. **When to use which sub-command:** - `track follow-wallet` — user asks "what did the wallets I follow trade?", "show me my follow list trades", "show my followed wallet activity" → requires wallets followed v