Agent skill · data analytics · gmgnai
gmgn-portfolio
Analyze one or many crypto wallets by address — holdings, batch realized/unrealized P&L, win rate, trading history, performance stats, specific token balance, and tokens created by a developer wallet (with ATH market cap and DEX graduation status) via GMGN API on Solana, BSC, Base, or Ethereum. Use when user asks about wallet holdings, P&L (including comparing up to 100 wallets), win rate, what tokens a dev has launched, the highest ATH token a dev ever created, or wants a wallet report to decide whether to copy-trade or follow.
Why this skill is useful
Provides specific commands and domain knowledge for analyzing crypto wallet data that the AI wouldn't reliably generate on its own.
What it needs
Requires gmgn-cli installed locally. Requires gmgn account access. About 12k tokens when loaded. Last updated 2026-07-30. 424 stars on the source repository.
What this skill does
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. ⚠️ 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 wallet portfolio data based on the user's request. For full wallet analysis (holdings + stats + activity + verdict), follow docs/workflow-wallet-analysis.md Core Concepts realizedprofit vs unrealizedprofit — realizedprofit = profit locked in from completed sells (cash in hand). unrealizedprofit = paper gains on positions still held, calculated at current price. These are separate numbers — do not add them unless answering "total P&L including open positions." profitchange — A multiplier ratio, not a dollar amount. 1.5 = +150% return. 0 = break-even. -0.5 = -50% loss. Computed as totalprofit / cost. Do not display this as a raw decimal — convert to percentage for user-facing output. pnl — Profit/loss ratio from portfolio stats: realizedprofit / totalcost. Same multiplier format as profitchange. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills gmgnai/gmgn-portfolio