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.

BEFORE RUNNING ANY COMMAND: Run gmgn cli config check . If exit code is 0, proceed normally. If exit code is 1, (1) run gmgn cli config and show the output to the user; (2) once the user sends the API Key, run gmgn cli config apply <KEY to complete configuration and verification, then show the output to the user. If check returns an error (unknown option or command not found), tell the user to run npm install g gmgn cli to update, then retry. 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 via GMGN platform track kol — user asks "what are KOLs buying?", "show me influencer trades", "what are KOLs doing recently" → returns trades from known KOL wallets track smartmoney — user asks "what is smart money doing?", "show me whale trades", "what is smart money buying recently" → returns trades from smart money / whale wallets Do NOT confuse these three: follow wallet = wallets the user has personally followed on GMGN kol = platform tagged KOL / influencer wallets (not user specific) smartmoney = platform tagged smart money / whale wallets (not user specific) Sub commands Sub command Description track follow tokens Followed token list for a wallet — which tokens a wallet has bookmarked on GMGN, with full market data track follow token groups Follow token group names for a wallet — the group names and IDs the wallet uses to organise followed tokens track follow wallet Trade records from wallets the user personally follows on GMGN track kol Real time trades from KOL / influencer wallets tagged by GMGN track smartmoney Real time trades from smart money / whale wallets tagged by GMGN Supported Chains sol / bsc / base / eth / robinhood / arc / stable Prerequisites gmgn cli installed globally — if missing, run: npm install g gmgn cli GMGN API KEY configured in ~/.config/gmgn/.env — required for all sub commands GMGN PRIVATE KEY — required for track follow wallet only (signed auth); not needed for follow tokens , kol , or smartmoney Rate Limit Handling All tracking routes used by this skill go through GMGN's leaky bucket limiter with rate=20 and capacity=20 . Sustained throughput is roughly 20 ÷ weight requests/second, and the max burst is roughly floor(20 ÷ weight) when the bucket is full. Command Route Weight track follow tokens GET /v1/user/follow tokens 3 track follow token groups GET /v1/user/follow token groups 1 track follow wallet GET /v1/trade/follow wallet 3 track kol GET /v1/user/kol 1 track smartmoney GET /v1/user/smartmoney 1 When a request returns 429 : On RATE LIMIT EXCEEDED , tell the user exactly: 已达到当前套餐的限频上限，点击 https://gmgn.ai/ai?chain=bsc&tab=paid plans 升级套餐，获得更高速率限制 . Show this upgrade guidance at most once per user task. Do not repeat it for subsequent RATE LIMIT BANNED responses during the same cooldown. Read X RateLimit Reset from the response headers. It is a Unix timestamp in seconds that marks when the limit is expected to reset. If the response body contains reset at (e.g., {"code":429,"error":"RATE LIMIT BANNED","message":"...","reset at":1775184222} ), extract reset at — it is the Unix timestamp when the ban lifts (typically 5 minutes). Convert to local time and tell the user exactly when they can retry. The CLI may wait and retry once automatically when the remaining cooldown is short. If it still fails, stop and tell the user the exact retry time instead of sending more requests. For RATE LIMIT EXCEEDED or RATE LIMIT BANNED , repeated requests during the cooldown can extend the ban by 5 seconds each time, up to 5 minutes. Do not spam retries. Usage Examples track follow tokens Options Option Description chain Required. sol / bsc / base / eth / robinhood / arc / stable wallet <address Required. Wallet address to query group id <id Filter by group: all group (all tokens across groups), default (default group), or a user defined group ID interval <interval Time interval for price change stats (e.g. 1m , 5m , 1h , 6h , 24h ) order by <field Sort field: created at / swaps / volume / market cap / liquidity / price / open timestamp direction <dir Required when order by is set. asc / desc limit <n Page size cursor <cursor Pagination cursor from previous response search <text Search by token name or address track follow tokens Response Fields Top level fields: Field Description cursor Opaque cursor for fetching the next page all following Total number of followed tokens is recommend Whether results include recommended tokens followings Array of followed token objects Each item in followings contains: Field Description address Token contract address symbol Token ticker symbol name Token name chain Chain the token is on price Current token price price change percent Price change percentage volume Trading volume liquidity Pool liquidity market cap Market cap swaps Total swaps group ids Follow groups this token belongs to open timestamp Unix timestamp when trading opened track follow token groups Options Option Description chain Required. sol / bsc / base / eth / robinhood / arc / stable wallet <address Required. Wallet address to query track follow token groups Response Fields data is an array. Each item contains: Field Description chain Chain the group is on group id Group identifier (e.g. default , or a user defined ID) group name Human readable group name rank Display order / sort rank track follow wallet Options Option Description chain Required. sol / bsc / base / eth / robinhood / arc / stable wallet <address Filter by wallet address limit <n Page size (1–100, default 10) side <side Trade direction: buy / sell filter <tag... Repeatable filter conditions min amount usd <n Minimum trade amount (USD) max amount usd <n Maximum trade amount (USD) track kol / track smartmoney Options Option Description chain <chain Required. Chain: sol / bsc / base / eth limit <n Page size (1–200, default 100) side <side Filter by trade direction: buy / sell (client side filter — applied locally after fetching results) track follow wallet Response Fields Top level fields: Field Description next page token Opaque token for fetching the next page of results list Array of trade records Each item in list contains: Field Description id Record ID (base64 encoded, use as cursor) chain Chain name (e.g. sol ) transaction hash On chain transaction hash maker Wallet address of the followed wallet side Trade direction: buy or sell base address Token contract address quote address Quote token address (SOL native address for buys/sells on SOL) base amount Token quantity in smallest unit quote amount Quote token amount spent / received (e.g. SOL) amount usd Trade value in USD cost usd Same as amount usd — USD value of this transaction leg buy cost usd Original buy cost in USD ( 0 if this record is the buy itself) price Token price denominated in quote token at time of trade price usd Token price in USD at time of trade price now Token current price in USD price change Price change ratio since trade time (e.g. 6.66 = +666%) timestamp Unix timestamp of the trade is open or close 1 = full position open or close; 0 = partial add or reduce launchpad Launchpad display name (e.g. Pump.fun ) launchpad platform Launchpad platform identifier (e.g. Pump.fun , pump agent ) migrated pool exchange DEX the token migrated to, if any (e.g. pump amm ); empty if not migrated base token.symbol Token ticker symbol base token.logo Token logo image URL base token.hot level Hotness level ( 0 = normal, higher = trending) base token.total supply Total token supply (string) base token.token create time Unix timestamp when token was created base token.token open time Unix timestamp when trading opened ( 0 if not yet migrated/opened)

gmgn-track