gmgn-portfolio Skill for Claude Code: Wallet Analysis

Lets your agent analyze crypto wallets by address: holdings, profit and loss, win rate, trade history and the tokens a developer wallet created.

Installs: 18.3K; on skills.sh
Stars: 636; on GitHub
Updated: Oct 2026; last repo commit

The skill makes your agent run seven gmgn-cli portfolio commands. They cover your own API-key wallets, wallet holdings, transaction history, trading stats, batch profit and loss for 1 to 100 wallets, the balance of one token, and the tokens a developer wallet created with their peak market cap and graduation status.

It needs the gmgn-cli tool and a GMGN API key. One command, portfolio holdings, also needs a second key, GMGN_PRIVATE_KEY, which signs the request. It works on Solana, BSC, Base and Ethereum, plus other chains the CLI lists.

Good for

Traders deciding whether a wallet is worth following or copying
Researchers checking what a token developer has launched before
Anyone comparing profit and loss for up to 100 wallets at once

Install gmgn-portfolio

Claude Code

Copy this prompt.

Install the gmgn-portfolio skill in Claude Code. Run this command:

npm install -g gmgn-cli
npx skills add GMGNAI/gmgn-skills --skill gmgn-portfolio -a claude-code

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The skill only works with the gmgn-cli program installed and an API key set, so run the npm line first. The README's own command, npx skills add GMGNAI/gmgn-skills, installs every skill in the repo, including the swap and order skills; the --skill flag limits it to this one. Update the CLI with npm install -g gmgn-cli.

From the vendor's docs. Source.

What's in the skill

When it loads

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.

Sections in SKILL.md

Core Concepts
Sub-commands
Supported Chains
Prerequisites
Rate Limit Handling
Usage Examples
portfolio created-tokens Options
portfolio holdings Options
portfolio activity Options
portfolio stats Options
portfolio profits Options
Response Field Reference
Response envelopes — each route wraps differently
portfolio holdings — Key Fields
portfolio activity — Key Fields
portfolio stats — Key Fields

Key facts

Author: gmgnai
Repo: gmgnai/gmgn-skills, folder skills/gmgn-portfolio
Installs on skills.sh: 18,259 as of 2026-11-02
GitHub stars: 636 for the whole gmgnai/gmgn-skills repo
License: MIT (as detected by GitHub)
Last repo commit: 2026-10-29
What is inside: 1 file including SKILL.md
skills.sh audits: Gen Agent Trust Hub: pass; Socket: pass; Snyk: pass
Needs: gmgn-cli (npm, global), GMGN_API_KEY, and GMGN_PRIVATE_KEY for portfolio holdings

What it includes

Wallets bound to your API key
Shows the wallets and main currency balances tied to your API key. It needs no chain or wallet argument.
Network · portfolio info
Token holdings with profit and loss
Lists a wallet's holdings with cost, value and profit and loss. This command needs the signing key as well as the API key.
Network · portfolio holdings
Transaction history
Lists buys, sells, transfers in and out, and add and remove events, filtered by type.
Network · portfolio activity
Trading statistics, batch supported
Gives trading stats for one or several wallets passed as repeated wallet flags.
Network · portfolio stats
Batch profit and loss for 1 to 100 wallets
Compares realized and unrealized profit and win rate across many wallets in one request.
Try: “Compare profit and loss for these five wallets on Solana.”
Network · portfolio profits
Balance of one token in a wallet
Checks how much of a specific token a wallet holds.
Network · portfolio token-balance
Tokens a developer wallet launched
Lists tokens created by a wallet with market cap, all-time high and whether each graduated to a DEX.
Network · portfolio created-tokens

From the official docs

Permissions

Medium risk

It sends the wallet addresses you ask about to the GMGN API, and one command needs a second signing key on top of your API key. Keep both keys in the config file and out of the chat.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

The signing key is not a wallet key, but guard it
The repo's .env.example says GMGN_PRIVATE_KEY signs API requests and is not a blockchain wallet key, and that a leak would let someone forge requests as you. Keep the file private and out of chat.
Your API key can end up in the chat
If no key is set, SKILL.md has the agent ask you to send the key in the conversation and apply it with a gmgn-cli command. Create ~/.config/gmgn/.env yourself instead.
Wallet addresses go to GMGN
Every wallet you ask about is sent to the GMGN API. Do not paste wallets you need to keep private.
Workflow files are outside the skill folder
SKILL.md links to wallet-analysis and smart-money workflow docs in the repo docs folder. Installing only this skill does not include them.

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No switch is needed for this skill: its seven commands are queries. SKILL.md says holdings needs the API key plus GMGN_PRIVATE_KEY, which signs requests, and the others need the API key alone. Placing orders is done by other skills (gmgn-swap, gmgn-cooking), which the README says need the same private key and an IP-whitelisted key.
Talks to	The GMGN API receives the tokens, wallets and filters you ask about. npm download if gmgn-cli is missing or needs an update
Sign-in and keys	The API key lives in ~/.config/gmgn/.env, or in a project .env file that takes precedence.
Scopes	Runs gmgn-cli commands in your terminal Reads the GMGN API key from ~/.config/gmgn/.env portfolio holdings reads GMGN_PRIVATE_KEY, a request-signing key

Questions

What does gmgn-portfolio do?

It makes your agent analyze crypto wallets through GMGN. You can see holdings, profit and loss, win rate, history, a single token balance and what a developer wallet has created.

How do I install it?

Use the install box at the top of this page for the skill itself. The skill also needs the gmgn-cli command-line tool (npm install -g gmgn-cli) and a GMGN API key, which the README says you create at gmgn.ai/ai. The README's own npx skills add command installs the whole GMGN set, not only this skill.

Does it need an API key?

Yes, a GMGN API key in ~/.config/gmgn/.env. The holdings command also needs GMGN_PRIVATE_KEY, a key that signs requests. The .env.example in the repo says it is not a blockchain wallet key.

Can it move my funds?

The seven commands in this skill query data; SKILL.md says only portfolio holdings needs the signing key, and the rest use the API key alone. Swaps and orders are done by the separate gmgn-swap and gmgn-cooking skills that the README lists, and the README says they need the same GMGN_PRIVATE_KEY and an IP-whitelisted key.

Is it safe to use?

Its commands query data and none of them trades, but it handles an API key and a signing key and sends wallet addresses to GMGN. Keep both keys in the config file with tight file permissions, as the .env.example advises, and out of chat. Profit and win-rate figures describe past trades, and SKILL.md links workflows that judge whether a wallet is worth following; read those as the author's method, not advice.

How do I check a token a dev launched?

Ask for the created tokens of the developer wallet. If you only have a token address, the skill says to get the creator address from the token info first.

Information

updated Nov 2, 2026

Repository: gmgnai/gmgn-skills
Folder: skills/gmgn-portfolio

gmgnai/gmgn-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6