gmgn-portfolio
gmgn portfolio
What it does
- gmgn-cli installed globally — if missing, run: npm install -g gmgn-cli
- GMGNAPIKEY configured in ~/.config/gmgn/.env
- Read X-RateLimit-Reset from the response headers. It is a Unix timestamp in seconds that marks when the limit is expected to reset.
- For RATELIMITEXCEEDED or RATELIMITBANNED, repeated requests during the cooldown can extend the ban by 5 seconds each time, up to 5 minutes. Do not spam retries.
- portfolio stats supports multiple --wallet flags for batch queries
- Use --raw to get single-line JSON for further processing
- For follow-wallet, KOL, and Smart Money trade records, use the gmgn-track skill (track follow-wallet / track kol / track smartmoney)
Requirements & configuration
- cost vs usdvalue — In holdings: cost is the historical amount spent buying this token (your cost basis); usdvalue is the current market value of the position. The difference is unrealized P&L.
- historyboughtcost vs cost — historyboughtcost is the all-time cumulative spend on this token (including positions already sold). cost is the cost basis of the current open position only.
- | portfolio info | Wallets and main currency balances bound to the API Key |
- | portfolio holdings | Wallet token holdings with P&L |
- | portfolio token-balance | Token balance for a specific token |
Configuration: GMGN_API_KEYGMGN_PRIVATE_KEYRATE_LIMIT_EXCEEDEDRATE_LIMIT_BANNED
Derived from the skill's own SKILL.md documentation · extracted 2026-07-23
gmgn-portfolio FAQ
What does the gmgn-portfolio skill do?
Analyze any crypto wallet by address — holdings, 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 a wallet's holdings, P&L, 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. gmgn-cli installed globally — if missing, run: npm install -g gmgn-cli GMGNAPIKEY configured in ~/.config/gmgn/.env
What does gmgn-portfolio require?
cost vs usdvalue — In holdings: cost is the historical amount spent buying this token (your cost basis); usdvalue is the current market value of the position. The difference is unrealized P&L. historyboughtcost vs cost — historyboughtcost is the all-time cumulative spend on this token (including positions already sold). cost is the cost basis of the current open position only. | portfolio info | Wallets and main currency balances bound to the API Key | | portfolio holdings | Wallet token holdings with P&L | | portfolio token-balance | Token balance for a specific token | Configuration keys: GMGN_API_KEY, GMGN_PRIVATE_KEY, RATE_LIMIT_EXCEEDED, RATE_LIMIT_BANNED.
How do I install gmgn-portfolio?
Run: npx -y skills add https://github.com/gmgnai/gmgn-skills --skill gmgn-portfolio --agent claude-code — the source lives at github.com/gmgnai/gmgn-skills.
Maintain gmgn-portfolio?
Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.
[](https://getagentictools.com/skills/gmgnai-gmgn-skills-gmgn-portfolio?ref=badge) npx agentictools info skills/gmgnai-gmgn-skills-gmgn-portfolio The second line is the CLI lookup for this page — handy in READMEs and docs.
