# Gmgn Portfolio

Analyze one or many crypto wallets by address, holdings, batch realized/unrealized...

- Repository: https://github.com/GMGNAI/gmgn-skills (636 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add GMGNAI/gmgn-skills --skill gmgn-portfolio -g -a claude-code -y`
Codex: `npx skills add GMGNAI/gmgn-skills --skill gmgn-portfolio -g -a codex -y`
Cursor: `npx skills add GMGNAI/gmgn-skills --skill gmgn-portfolio -g -a cursor -y`
Gemini CLI: `npx skills add GMGNAI/gmgn-skills --skill gmgn-portfolio -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add GMGNAI/gmgn-skills`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

**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`](../../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."

The rest: https://github.com/GMGNAI/gmgn-skills/blob/HEAD/skills/gmgn-portfolio/SKILL.md