Gmgn Portfolio
Pull structured wallet holdings, P&L, win rate, and dev-launched token stats over GMGN’s CLI before you copy-trade or follow an on-chain wallet.
Overview
gmgn-portfolio is an agent skill most often used in Validate (also Idea research and Operate iteration) that builds GMGN CLI wallet reports for holdings, P&L, and dev-token history to inform copy-trade decisions.
Install
npx skills add https://github.com/gmgnai/gmgn-skills --skill gmgn-portfolioWhat is this skill?
- Queries holdings, realized/unrealized P&L, win rate, activity, and aggregate stats via gmgn-cli only
- Supports Solana, BSC, Base, and Ethereum with subcommands: info, holdings, activity, stats, token-balance, created-token
- Surfaces dev-created tokens with ATH market cap and DEX graduation status for launcher due diligence
- Explicit IPv4-only guidance and 401/403 troubleshooting when outbound traffic uses IPv6
- Forbids web scrape of gmgn.ai; CLI is the mandated data path with structured output
- 6 portfolio subcommands: info, holdings, activity, stats, token-balance, created-tokens
- 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 wallet address but no trustworthy, structured P&L and launcher history without fighting GMGN’s logged-in web UI or broken IPv6 egress.
Who is it for?
Indie on-chain traders and agent workflows that vet wallets before mirroring trades or following dev deployers.
Skip if: Builders who need portfolio tracking inside their own SaaS without GMGN credentials, or anyone who cannot run gmgn-cli over IPv4.
When should I use this skill?
User asks about wallet holdings, P&L, win rate, dev-launched tokens, ATH of created tokens, or wants a wallet report to decide copy-trading or following.
What do I get? / Deliverables
Your agent returns CLI-sourced wallet stats and token-launcher context you can use to accept or reject copy-trading that wallet.
- Structured wallet portfolio report from gmgn-cli
- Per-token balance or created-token catalog with graduation/ATH fields when requested
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Canonical shelf is Validate because the skill’s payoff is a decision report (follow, copy-trade, or pass), not passive browsing. Pricing/investment framing fits sizing risk and expected edge from wallet stats rather than building product features.
Where it fits
Scan a trending wallet’s created-tokens list and ATH caps before you commit to a niche strategy.
Compare win rate and realized P&L against your risk budget before enabling copy-trade.
Re-run stats and activity after a week of mirroring to see if edge decayed.
How it compares
Use for GMGN CLI wallet dossiers, not generic crypto price MCPs or manual gmgn.ai browsing.
Common Questions / FAQ
Who is gmgn-portfolio for?
Solo builders and traders who use Claude Code, Cursor, or Codex to diligence wallets on Solana, BSC, Base, or Ethereum before they follow or copy-trade.
When should I use gmgn-portfolio?
Use it in Validate when a wallet report should drive a follow/copy decision; in Idea research when mapping what a dev wallet has launched; and in Operate when re-checking performance after you start mirroring a strategy.
Is gmgn-portfolio safe to install?
The skill steers agents toward authenticated CLI calls and away from scraping; review the Security Audits panel on this page and treat GMGN API keys as secrets you never commit.
SKILL.md
READMESKILL.md - Gmgn Portfolio
**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`](../../docs/workflow-wallet-analysis.md)** ## Core Concepts - **`realized_profit` vs `unrealized_profit`** — `realized_profit` = profit locked in from completed sells (cash in hand). `unrealized_profit` = 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." - **`profit_change`** — A multiplier ratio, not a dollar amount. `1.5` = +150% return. `0` = break-even. `-0.5` = -50% loss. Computed as `total_profit / cost`. Do not display this as a raw decimal — convert to percentage for user-facing output. - **`pnl`** — Profit/loss ratio from `portfolio stats`: `realized_profit / total_cost`. Same multiplier format as `profit_change`. A `pnl` of `2.0` means the wallet doubled its money on completed trades over the period. - **`winrate`** — Ratio of profitable trades over the period (0–1). `0.6` = 60% of trades were profitable. Does not reflect the size of wins vs losses — a wallet can have high winrate but net negative if losses are large. - **`cost` vs `usd_value`** — In holdings: `cost` is the historical amount spent buying this token (your cost basis); `usd_value` is the current market value of the position. The difference is unrealized P&L. - **`history_bought_cost` vs `cost`** — `history_bought_cost` is the all-time cumulative spend on this token (including positions already sold). `cost` is the cost basis of the current open position only. - **Pagination (`cursor`)** — Activity results are paginated. The response includes a `next` field; pass it as `--cursor` to fetch the next page. An empty or missing `next` means you are on the last page. ## Sub-commands | Sub-command | Description | |-------------|-------------| | `portfolio info` | Wallets and main currency balances bound to the API Key | | `portfolio holdings` | Wallet token holdings with P&L | | `portfolio activity` | Transaction history | | `portfolio stats` | Trading statistics (supports batch) | | `portfolio token-balance` | Token balance for a specific token | | `portfolio created-tokens` | Tokens created by a developer wallet, with market cap and ATH info | ## Supported Chains `sol` / `bsc` / `base` / `eth` ## Prerequisites - `gmgn-cli` installed globally — if missing, run: `npm install -g gmgn-cli` - `GMGN_API_KEY` configured in `~/.conf