gmgn-cli

English | 简体中文

GMGN Agent Skills

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, one-command cooking orders (buy + condition orders in a single flow), and wallet management — including real-time holdings, recent P&L, and transaction history — all through natural language.

---

Why GMGN Skills

Built for AI agents to query and trade multi-chain Meme tokens at high speed in real time. gmgn-skills gives AI agents direct access to GMGN's trending tokens, Trenches new token listings, and professional on-chain data — including Smart Money, KOL, rat trader, and bundler analytics.

With 500+ professional data dimensions, you can turn your AI agent into a 24/7 real-time chain-scanning trading tool — monitoring multi-chain token momentum, placing orders instantly, and managing exits with take-profit / stop-loss, all on autopilot.

1. Real-time on-chain data — faster

Data across SOL / BSC / Base / ETH is live on every query. Supports multi-parameter customization, no snapshot cache — built for AI agent real-time decision-making (including but not limited to):

Data	Granularity
New token discovery (Trenches)	Real-time, filtered by launchpad, dev holdings, KOL entry, rat trader ratio
Trending tokens	Real-time, 1m / 5m / 1h / 6h / 24h — minimum 1-minute window
Token info	Real-time — trade activity / price / volume / market cap
Token security	Real-time — open source, renounced, honeypot detection, etc.
Token analytics	Real-time — Dev / KOL / Smart Money / rat trader / bundler wallet holdings
Monitoring & tracking	Real-time — KOL / Smart Money / followed wallet trade activity
K-line (OHLCV)	Real-time, 1m / 5m / 15m / 1h / 4h / 1d — minimum 1-minute candles
Wallet holdings	Real-time — holdings / P&L / trade activity

2. Trade faster

• Same RPC routing as GMGN's web trading interface, multi-region deployment, millisecond response — order submission under 0.3 seconds end-to-end.
• Automatic best-route selection, the same routing engine as GMGN web.
• Market orders, limit orders, and strategy orders (take-profit / stop-loss) in a single command.
• Sell by position percentage (--percent 50) without calculating exact amounts.

Order Type	Description
Market Order	Instant execution at current market price
Limit Order	Trigger buy or sell at a specified price
Take-Profit / Stop-Loss	Fixed-price exit conditions attached to a swap
Trailing Take-Profit / Trailing Stop-Loss	Tracks price peak; fires after a specified drawdown % — rides momentum while protecting gains
Multi-Wallet Batch Trading	Buy with multiple wallets simultaneously, each with its own take-profit / stop-loss / trailing take-profit / trailing stop-loss orders

3. More comprehensive token data

No more scraping web pages or getting blocked by Cloudflare. Query all the professional analytics needed for high-frequency Meme token trading, with high concurrency in real time (including but not limited to):

• Smart money count (smart_degen_count) and KOL holders (renowned_wallets) — live
• Rat trader ratio (rat_trader_amount_rate) — volume share from insider/sneak wallets
• Bundler bot exposure (bundler_trader_amount_rate) — volume from bot-bundled buys
• Sniper wallets (sniper_count) — wallets that bought at the exact moment of launch
• Suspected insider hold rate (suspected_insider_hold_rate)
• Fresh wallet ratio (fresh_wallet_rate)
• Rug ratio score (0–1) + honeypot detection + wash-trade flag
• Bonding curve status (is_on_curve) — whether the token has graduated to open DEX

4. What you can do with GMGN Skills

Real-time chain scanning

• Scan Trenches for new tokens, filtered by launchpad (Pump.fun, letsbonk, fourmeme, clanker…), dev holdings, KOL entry, and rat trader ratio in real time
• Browse multi-chain trending token rankings (minimum 1-minute granularity), sorted by volume, smart money count, market cap, and more
• Track new tokens in real time — see which tokens KOLs, Smart Money, and wallets you follow are buying, and auto-analyze the latest hot tokens
• Fetch real-time K-line / OHLCV data for any token (1m / 5m / 15m / 1h / 4h / 1d)

Token analytics

• Query token fundamentals, social links, Bonding Curve status, and liquidity pool details
• Security check: open source, renounced, honeypot, wash trading, Rug ratio score (0–1)
• Deep holder analysis: Smart Money / KOL / rat trader / bundler / sniper / whale / fresh wallet — holdings breakdown and rankings

Wallet & tracking

• Analyze any wallet: real-time holdings, realized / unrealized P&L, win rate, trade style, full history
• Track the latest buys and sells from Smart Money, KOL, and wallets you follow in real time

Automated trading

• Market orders, limit orders, take-profit / stop-loss strategy orders — end-to-end latency under 0.3 seconds
• One-command sell by position percentage (--percent 50), no manual calculation needed

AI workflows

• 9 built-in workflow docs: token research, project deep report, wallet analysis, Smart Money profiling, risk warning, early project screening, daily brief, market discovery, and more — ready to use out of the box

---

Skills

Skill	Description	Reference
/gmgn-token	Token info, security, pool, holders, traders	SKILL.md
/gmgn-contract-dd	Contract due-diligence score for one token address — safety, holder structure and price action as a single 0-100 verdict	SKILL.md
/gmgn-holder-analysis	Token holder chip analysis — chip distribution, entry cost, whale/dev/KOL behavior, risk wallets	SKILL.md
/gmgn-market	K-line market data, trending tokens	SKILL.md
/gmgn-portfolio	Wallet holdings, activity, stats	SKILL.md
/gmgn-wallet-analysis	Wallet decision dossier — four pass/fail gates plus what the wallet holds and is buying now	SKILL.md
/gmgn-wallet-score	Wallet copy-trade scoring — track-record, copy-tradeability, backtest, Dev reputation	SKILL.md
/gmgn-track	Follow-wallet trades, KOL trades, Smart Money trades	SKILL.md
/gmgn-token-buy	Buy-side due diligence — resolves a token name to the right contract, three hard gates, slippage and gas sizing, order card handed to gmgn-swap	SKILL.md
/gmgn-swap	Swap submission + limit orders + strategy orders + order query	SKILL.md
/gmgn-cooking	One-command cooking orders (buy + take-profit/stop-loss in a single flow)	SKILL.md
/gmgn-kline-pattern	Price-action pattern reading — names the chart pattern and scores it 0-100	SKILL.md

For detailed CLI commands, parameters, and recommended values, see the Wiki documentation.

Quick Start

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) — 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).

Ready to install? Jump to Installation →

Already installed? 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

npx skills add GMGNAI/gmgn-skills

Step 2 — Verify CLI installation (demo key)

GMGN_API_KEY=gmgn_solbscbaseethmonadtron gmgn-cli market trending --chain sol --interval 1h --limit 3

If JSON output appears, the CLI is installed correctly. Setup is NOT yet complete — this is a public demo key for testing only. You must continue to Steps 3–4 to configure the user's personal API key. Do not stop here.

Step 3 — REQUIRED: Set up personal API key

⚠️ This step is mandatory. The demo key in Step 2 supports testing only and is not for actual use.

Immediately tell the user the following, then run the key generation command without waiting for them to ask:

"To use GMGN Skills, you need your own API key from https://gmgn.ai/ai. I'm generating an Ed25519 key pair for you now."

Run:

openssl genpkey -algorithm ed25519 -out /tmp/gmgn_private.pem 2>/dev/null && \
  openssl pkey -in /tmp/gmgn_private.pem -pubout 2>/dev/null

Show the public key to the user with the following instructions:

This is your Ed25519 public key. Please complete these two steps:

1. Go to https://gmgn.ai/ai, paste the public key above into the API Key creation form, and submit.
2. Once created, copy the API Key shown on the page and send it back to me — I'll handle Step 4 configuration for you.

Wait for the user to reply with their API Key before continuing to Step 4.

Step 4 — Configure credentials

After the user receives their API key, write it to the global config:

mkdir -p ~/.config/gmgn
# Write API key (replace with the actual key the user provides)
echo 'GMGN_API_KEY=<user_api_key>' > ~/.config/gmgn/.env
chmod 600 ~/.config/gmgn/.env

If the user also needs swap or order capability, append the private key:

# Append private key (use the PEM content from Step 3)
echo 'GMGN_PRIVATE_KEY="<pem_content>"' >> ~/.config/gmgn/.env

Step 5 — Verify

gmgn-cli market trending --chain sol --interval 1h --limit 3

If output appears without error, setup is complete.

---

Upgrade (AI Agent)

Run these two commands to upgrade both the CLI and Skills to the latest version.

npm install -g gmgn-cli
npx skills add GMGNAI/gmgn-skills

Check the installed version after upgrading:

gmgn-cli --version

For the full upgrade reference, see Section 10 — Upgrade Skills and CLI.

---

Demo Cases

Trending Token Rankings

Send this prompt to your AI Agent: