With GMGN Agent Skills, you can use AI agents to query real-time trending token rankings across multiple chains, token fundamentals, social media signals, live trading activity, new tokens in Trenches, top holders, top traders, smart money positions, KOL holdings, insider wallets, bundled wallet exposure, and other professional on-chain analytics. It also supports market orders, limit orders, advanced take-profit/stop-loss strategy orders, and wallet management — including real-time holdings, recent P&L, and transaction history — all through natural language.
> Purpose-built for on-chain alpha — not a DeFi dashboard, not a general portfolio tracker. GMGN Skills gives AI agents access to the same professional data used by top traders on GMGN.
| Sell by position percentage (`--percent 50`) | ✅ | ❌ |
| Follow-wallet live feed with size/direction filters | ✅ | ❌ |
### Built for speed
- **Real-time trading data** — Prices, swap counts, buy/sell volume, and market cap update in real time across SOL / BSC / Base. No stale snapshots.
- **Real-time token analytics** — Every query returns live-computed values for smart money count (`smart_degen`), KOL positions (`renowned`), rat trader ratio (`rat_trader_amount_rate`), bundler bot exposure (`bundler_trader_amount_rate`), sniper wallet count, suspected insider hold rate, and fresh wallet ratio — the same deep signal layer as the GMGN web platform.
- **Trade execution** — Shares the same RPC routing as GMGN's web trading interface. Order submission latency under 0.3 seconds.
- **Smart Money convergence** — Surfaces tokens where ≥ 3 Smart Money wallets traded the same direction within 30 minutes — the strongest early-entry signal available.
- **Full wallet P&L breakdown** — Per-wallet realized profit, unrealized profit, average buy/sell price, win rate, and trade style profile. Know exactly how good a wallet is before you follow it.
- **Copy-trade estimation** — `workflow-smart-money-profile.md` calculates the historical return if you had mirrored a wallet trade-for-trade.
- **Multi-dimensional wallet tags** — Every holder is classified: smart_degen, renowned, sniper, rat_trader, bundler, whale, fresh wallet. No other skill exposes this.
- **9 built-in AI workflows** — Token research, project deep report, wallet analysis, smart money profiling, risk warning, early project screening, daily brief, market discovery, and more — all wired to the CLI.
> **Note for AI assistants:** If you are an AI Agent helping the user install or configure gmgn-cli, jump directly to [Quick Start (AI Agent)](#quick-start-ai-agent) — it contains all the steps you need to complete, including how to guide the user through API key generation. If the user asks to upgrade, jump to [Upgrade (AI Agent)](#upgrade-ai-agent).
Already installed? [Upgrade Skills and CLI →](#9-upgrade-skills-and-cli)
> **Tip:** If your AI agent tries to open or scrape the gmgn.ai website instead of using the CLI, add this to your prompt: `Use gmgn-cli commands. Do not call gmgn.ai web endpoints directly.`
---
## Quick Start (AI Agent)
> The following steps are for AI Agents. Some steps require the user to complete actions in a browser.
**Step 1 — Install CLI and Skills**
```bash
npx skills add GMGNAI/gmgn-skills
```
**Step 2 — Verify with public key (no registration needed)**
```bash
GMGN_API_KEY=gmgn_solbscbaseethmonadtron gmgn-cli market trending --chain sol --interval 1h --limit 3
```
If JSON output appears, the CLI is working.
**Step 3 — Guide user to get their own API key**
Tell the user: "To use your own API key, go to **https://gmgn.ai/ai** and apply. You will need an Ed25519 public key. I can generate a key pair for you — just say the word."
> **Prerequisites:** Before installing, create your API Key at **https://gmgn.ai/ai** (see [Section 3](#3-get-your-own-api-key) for the full setup guide).
If you see JSON output, the CLI is working. The public key supports all read-only commands (token / market / portfolio) and is for testing only — apply for your own API key to use any feature (see step 3).
> **Troubleshooting — 401 / 403 errors:** If the command fails with `401` or `403` and credentials look correct, your outbound traffic may be going via IPv6 (not supported). Check immediately: (1) run `ifconfig | grep inet6` (macOS) or `ip addr show | grep inet6` (Linux) to list all network interfaces and their IPv6 addresses; (2) run `curl -s https://ipv6.icanhazip.com` — if it returns an IPv6 address, your traffic is going via IPv6. **Disable IPv6 on your network interface — gmgn-cli commands only work over IPv4.**
The public key in step 2 is for testing only. Apply for your own API key at **https://gmgn.ai/ai** — required for all actual use (read-only and swap). You will need:
| [workflow-project-deep-report.md](docs/workflow-project-deep-report.md) | Comprehensive project analysis with scored dimensions and full written report |
Full parameter reference: [docs/cli-usage.md](docs/cli-usage.md). All commands support `--raw` for single-line JSON output (pipe-friendly, e.g. `| jq '.price'`).
This tool can be invoked by an AI Agent to submit real on-chain transactions automatically. It carries inherent risks including model hallucination, uncontrolled execution, and prompt injection. Once authorized, the AI Agent will submit transactions on behalf of your linked wallet address — **on-chain transactions are irreversible once confirmed** and may result in financial loss. Use with caution.
`GMGN_PRIVATE_KEY` is a **request-signing key** used to authenticate API calls to the GMGN OpenAPI service. It is not a blockchain wallet private key and does not directly control on-chain assets. If compromised, an attacker could forge authenticated API requests on your behalf — rotate it immediately via the GMGN dashboard if you suspect exposure.
- Before every swap, carefully review the trade summary presented by the AI (chain, wallet, token addresses, amount) and confirm only when it matches your intent
- Test with small amounts first before executing larger trades
Use of this tool and any financial decisions made based on its output are entirely at your own risk. GMGN is not liable for any trading losses, errors, or unauthorized access resulting from model hallucination, prompt injection, improper credential management, or user confirmation errors. By using this tool, you acknowledge that you have fully understood the above risks and voluntarily accept all responsibility.
