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
Core Concepts
-
realized_profitvsunrealized_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 astotal_profit / cost. Do not display this as a raw decimal — convert to percentage for user-facing output. -
pnl— Profit/loss ratio fromportfolio stats:realized_profit / total_cost. Same multiplier format asprofit_change. Apnlof2.0means 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. -
costvsusd_value— In holdings:costis the historical amount spent buying this token (your cost basis);usd_valueis the current market value of the position. The difference is unrealized P&L.