gmgn-track skill for Claude: follow smart money and KOL wallets

Lets your agent read what smart-money, KOL and followed wallets are buying and selling on crypto chains, through GMGN. For on-chain researchers.

Installs: 17.9K; on skills.sh
Stars: 636; on GitHub
Updated: Oct 2026; last repo commit

gmgn-track makes your agent pull recent trades from wallets that GMGN tags as smart money or KOL, or from wallets you follow on GMGN, and turn them into a readable feed. It can also list which tokens a wallet has followed. It flags when several wallets trade the same token in the same direction, which it calls a cluster signal.

It loads when you ask what smart money or KOLs are buying, or about whale alerts and copy-trade ideas. It runs the gmgn-cli command line, which you install with npm, and needs a GMGN API key. Followed-wallet trades also need a private signing key. Its five sub-commands all return trade records or lists, and SKILL.md defines no trading command. Trading is a separate skill, gmgn-swap.

Good for

Crypto traders who watch what smart-money wallets are doing
Researchers comparing KOL trades with smart-money trades
GMGN users who want a readable feed of the wallets they follow

Install gmgn-track

Claude Code

Copy this prompt.

Install the gmgn-track skill in Claude Code. Run this command:

npm install -g gmgn-cli
npx skills add GMGNAI/gmgn-skills --agent claude-code --skill gmgn-track

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The README's general install is npx skills add GMGNAI/gmgn-skills, which adds every GMGN skill. The commands above install only this one. The README also says gmgn-cli works only over IPv4.

From the project README. Source.

What's in the skill

When it loads

Get real-time crypto buy/sell activity from Smart Money wallets, KOL influencer wallets, and personally followed wallets via GMGN API — alpha signals, whale tracking, meme token copy-trading ideas on Solana, BSC, Base, or Ethereum. Also query which tokens a wallet has followed (bookmarked) on GMGN. Use when user asks what smart money or KOLs are buying, wants whale alerts, on-chain alpha, copy-trade signals, or wants to check a wallet's followed tokens. (For a specific wallet address's portfolio, use gmgn-portfolio.)

Sections in SKILL.md

Core Concepts
Sub-commands
Supported Chains
Prerequisites
Rate Limit Handling
Usage Examples
track follow-tokens Options
track follow-tokens Response Fields
track follow-token-groups Options
track follow-token-groups Response Fields
track follow-wallet Options
track kol / track smartmoney Options
track follow-wallet Response Fields
track kol / track smartmoney Response Fields
Smart Money Behavior Interpretation
1. Signal Strength Levels

Key facts

Author: GMGN
License: MIT
Installs on skills.sh: 17,889 (Nov 2, 2026)
GitHub stars: 636 for the whole repo (Nov 2, 2026)
Last commit: Oct 29, 2026
Files: 1 file (SKILL.md only)
Needs: gmgn-cli (npm install -g gmgn-cli) and a GMGN_API_KEY
Extra key: GMGN_PRIVATE_KEY only for track follow-wallet
Chains: sol, bsc, base, eth, arbitrum, hyperevm, robinhood, arc, stable, avalanche
Rate limits: Free 5/5, Plus 20/20, Pro 50/50 (rate/capacity)

What it includes

Run gmgn-cli config --check first
If the key is missing, the agent runs gmgn-cli config, shows you the output and asks you for your API key.
Runs code · Config check
Trades from wallets GMGN tags as KOLs
Recent buys and sells from influencer wallets. The skill says these carry social signal, not necessarily alpha.
Try: “What are KOLs buying on Solana right now?”
Network · track kol
Trades from wallets GMGN tags as smart money
Recent trades from wallets with a record of profitable trades by GMGN's algorithm.
Try: “Show me what smart money bought in the last hour on SOL.”
Network · track smartmoney
Trades from wallets you follow on GMGN
Uses the follow list of the GMGN account behind your API key. Needs the private key for a signed request.
Network · track follow-wallet
Tokens a wallet has followed on GMGN
Lists a wallet's followed tokens with market data. Needs a wallet address.
Network · track follow-tokens
Group names a wallet uses for followed tokens
Returns the group names and IDs.
Network · track follow-token-groups
Cluster signals and red flags
Groups trades by token, flags three or more wallets buying within about 30 minutes, and lists warning patterns such as smart money selling.
Signal reading
Stop and report the retry time
On a 429 it reads the reset time, tells you when to retry and does not keep sending requests.
Network · Rate-limit handling

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only modeHow to turn it on

Watch out for

Installs a global npm program and keeps keys in a file
You install gmgn-cli with npm install -g and put your API key in ~/.config/gmgn/.env, a plaintext file (the README says to chmod 600 it). The README's setup also has the agent run openssl to write a key file to /tmp/gmgn_private.pem and asks you to send the API key back in chat. Use a key made for this. github.com
Followed-wallet output reveals your follow list
The skill says follow-wallet results expose which wallets you follow on GMGN, so do not share raw output publicly. github.com
Signals are not advice
The skill labels wallets using GMGN tags and simple rules like cluster counts. Verify a token yourself before trading on it. github.com

Technical details

Turning on read-only	SKILL.md defines only query sub-commands (track kol, smartmoney, follow-wallet, follow-tokens, follow-token-groups). Trading lives in the separate gmgn-swap skill.
Talks to	GMGN OpenAPI via gmgn-cli
Sign-in and keys	API key (and the signing key for follow-wallet) in plaintext in ~/.config/gmgn/.env; the README has you set file mode 600. The README says the private key is a request-signing key, not a blockchain wallet key.
Scopes	GMGN_API_KEY GMGN_PRIVATE_KEY (follow-wallet only)

Questions

What does gmgn-track do?

It reads on-chain trade activity from GMGN: what smart-money wallets, KOL wallets and wallets you follow are buying and selling. It presents a feed and highlights tokens that several wallets trade in the same direction.

How do I install it in Claude Code, the Claude app or Codex?

Use the install box above. It also installs the gmgn-cli command line, which the skill calls for everything. The README documents the skills CLI, a Codex git clone, and OpenCode and Cline routes. It does not document a Claude app upload.

Does it need an API key?

Yes. It needs a GMGN API key, which you create at gmgn.ai/ai, in ~/.config/gmgn/.env. The follow-wallet command also needs GMGN_PRIVATE_KEY for signed requests. Rate limits depend on your GMGN plan (Free 5/5, Plus 20/20, Pro 50/50 rate/capacity); SKILL.md does not say what the plans cost.

Is it safe to install?

It queries GMGN data and defines no trading command, but it still runs a third-party npm program and keeps your API key in a plaintext file on your machine (~/.config/gmgn/.env). Followed-wallet output shows your follow list, so do not post it publicly. Use an API key made for this and read the README's security section first.

Can it buy or sell tokens?

SKILL.md defines no buy or sell command: its five sub-commands return trade records and followed-token lists. Trading is the separate gmgn-swap skill in the same repo, which submits real transactions.

Is a smart-money signal a reason to buy?

No. The skill itself says KOL trades carry social and marketing signal, not necessarily alpha. Treat signals as leads to research and check the token yourself before acting.

Why do I get 401 or 403 errors?

The skill says to check for IPv6 first, because gmgn-cli commands work only over IPv4. If your traffic goes out on IPv6, disable IPv6 on your network interface.

Information

updated Nov 2, 2026

Repository: gmgnai/gmgn-skills
Folder: skills/gmgn-track

gmgnai/gmgn-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

gmgn-skills Readme · github.com
gmgn-skills .codex/INSTALL.md · github.com
gmgn-track SKILL.md · github.com