1.1.5

1.1.4
fix: remove pinned gmgn-cli version to always use latest
2026-07-28 01:07:44 +00:00 · 2026-03-27 15:54:47 +08:00 · 2026-03-27 15:22:07 +08:00 · 2026-03-27 15:19:22 +08:00 · 2026-03-27 14:19:57 +08:00 · 2026-03-26 22:10:58 +08:00
32 changed files with 2064 additions and 310 deletions
@@ -15,7 +15,7 @@
        "name": "GMGN"
      },
      "homepage": "https://gmgn.ai",
-      "repository": "https://github.com/gmgn-ai/gmgn-skills",
+      "repository": "https://github.com/GMGNAI/gmgn-skills",
      "license": "MIT",
      "keywords": [
        "gmgn",
@@ -6,7 +6,7 @@
    "name": "GMGN",
    "url": "https://gmgn.ai"
  },
-  "repository": "https://github.com/gmgn-ai/gmgn-skills",
+  "repository": "https://github.com/GMGNAI/gmgn-skills",
  "license": "MIT",
  "keywords": ["gmgn", "crypto", "solana", "token", "defi", "swap"],
  "skills": "./skills/"
@@ -12,7 +12,7 @@ Enable GMGN skills in Codex via native skill discovery. Just clone and symlink.
 1. **Clone the repository:**

   ```bash
-   git clone https://github.com/gmgn-ai/gmgn-skills ~/.codex/gmgn-cli
+   git clone https://github.com/GMGNAI/gmgn-skills ~/.codex/gmgn-cli
   ```

 2. **Create the skills symlink:**
@@ -6,7 +6,7 @@
    "name": "GMGN"
  },
  "homepage": "https://gmgn.ai",
-  "repository": "https://github.com/gmgn-ai/gmgn-skills",
+  "repository": "https://github.com/GMGNAI/gmgn-skills",
  "license": "MIT",
  "keywords": [
    "gmgn",
@@ -0,0 +1,40 @@
+name: CI
+
+on:
+  pull_request:
+    branches:
+      - main
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build (Node ${{ matrix.node-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        node-version:
+          - 20
+          - 24
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Verify publish artifact
+        run: npm pack --dry-run
@@ -0,0 +1,47 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          registry-url: https://registry.npmjs.org
+          cache: npm
+
+      - name: Ensure tag matches package version
+        run: |
+          PACKAGE_VERSION="$(node -p "require('./package.json').version")"
+          TAG_VERSION="${GITHUB_REF_NAME#v}"
+
+          if [ "$PACKAGE_VERSION" != "$TAG_VERSION" ]; then
+            echo "package.json version ($PACKAGE_VERSION) does not match tag ($TAG_VERSION)"
+            exit 1
+          fi
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Verify publish artifact
+        run: npm pack --dry-run
+
+      - name: Publish to npm
+        run: npm publish --access public
@@ -12,7 +12,7 @@ Enable GMGN skills in OpenCode via native skill discovery. Just clone and symlin
 1. **Clone the repository:**

   ```bash
-   git clone https://github.com/gmgn-ai/gmgn-skills ~/.opencode/gmgn-cli
+   git clone https://github.com/GMGNAI/gmgn-skills ~/.opencode/gmgn-cli
   ```

 2. **Register the plugin:**
@@ -2,6 +2,22 @@

 This file provides guidance to Claude Code when working with the gmgn-cli plugin.

+## CRITICAL RULE — Read This First
+
+**ALL queries about GMGN data MUST use `gmgn-cli` via the skills below.**
+
+This includes: trending tokens, token info, security checks, K-line / price history, wallet holdings, KOL trades, Smart Money trades, swaps, and any other on-chain data.
+
+**NEVER do any of the following to fetch GMGN data:**
+- Web search (e.g. searching "gmgn trending solana")
+- WebFetch / curl to gmgn.ai or any gmgn domain
+- Browser automation or scraping
+- Any method other than `gmgn-cli`
+
+**Why:** The gmgn.ai website requires login, uses dynamic rendering, and does not expose structured data. The CLI is the only correct and supported method. If you attempt to scrape the site, you will get no data or be blocked.
+
+**When a user asks anything about GMGN data — always invoke the matching skill and run the CLI command. No exceptions.**
+
 ## Project Overview

 This is a **Claude Code plugin** — a collection of GMGN OpenAPI skills for on-chain operations. It provides CLI tools and skills for token queries, market data, wallet portfolio analysis, and swap execution across sol / bsc / base.
@@ -11,14 +27,15 @@ This is a **Claude Code plugin** — a collection of GMGN OpenAPI skills for on-
 | Skill | Purpose | When to Use |
 |-------|---------|-------------|
 | `gmgn-token` | Token info, security, pool, holders, traders | User asks about a token's price, market cap, security risk, liquidity pool, top holders, or top traders; user wants to research a token before buying; user asks "is this token safe", "who holds this token", "what's the liquidity" |
-| `gmgn-market` | K-line / candlestick market data + trending tokens | User asks for price history, chart data, OHLCV candles; user wants to analyze price trends over time; user asks "show me the 1h chart", "what was the price last week", "give me kline data for this token"; user wants to discover hot or trending tokens; user asks "what tokens are trending", "show me top tokens by volume", "find hot tokens on SOL" |
+| `gmgn-market` | K-line / candlestick market data + trending tokens + newly launched launchpad tokens | User asks for price history, chart data, OHLCV candles, trading volume over time; user wants to analyze price trends; user asks "show me the 1h chart", "what was the price last week", "give me kline data for this token"; user wants to discover hot or trending tokens; user asks "what tokens are trending", "show me top tokens by volume", "find hot tokens on SOL"; **user asks about newly launched tokens, fresh tokens, latest tokens on launchpads** — e.g. "show me new tokens on pump.fun", "what tokens just launched on SOL", "find newly created tokens", "latest tokens on letsbonk" → use `market trenches --type new_creation` |
 | `gmgn-portfolio` | Wallet holdings, activity, trading stats, token balance | User asks about a wallet's holdings, P&L, transaction history, trading statistics, or token balance; user wants to analyze a wallet; user asks "what tokens does this wallet hold", "show me recent trades", "what's the win rate of this wallet" |
+| `gmgn-track` | Track trade activity of wallets I follow, KOL trades, Smart Money trades across chains | User asks about trades from wallets they follow; user wants to see what KOLs or Smart Money are buying/selling; user asks "show me what wallets I follow have traded recently", "what are KOLs buying", "show me smart money moves on BSC" |
 | `gmgn-swap` | Token swap execution + order status query | User wants to swap tokens, execute a trade, or check an order status; user asks "swap SOL for USDC", "buy this token", "check my order"; **requires private key configured in `.env`** |

 ## Architecture

 - **`src/`** — TypeScript source (CLI commands, API client, signer)
- **`skills/`** — 4 SKILL.md files for Claude Code skill definitions
+- **`skills/`** — 5 SKILL.md files for Claude Code skill definitions
 - **`dist/`** — Compiled output (generated by `npm run build`)
 - **`.claude-plugin/`** — Plugin metadata for Claude Code

@@ -53,7 +70,7 @@ EOF
 When creating or updating any file in `skills/`:

 - **Language**: English only — no bilingual content. SKILL.md files are read by AI, not humans.
- **Package runner**: Always use the pre-installed `gmgn-cli` binary (e.g. `gmgn-cli token info ...`). Never use `npx gmgn-cli` or `npx gmgn-cli@<version>` — npx downloads the package at runtime alongside live credentials. The package must be installed once with `npm install -g gmgn-cli@1.0.1`.
+- **Package runner**: Always use the pre-installed `gmgn-cli` binary (e.g. `gmgn-cli token info ...`). Never use `npx gmgn-cli` or `npx gmgn-cli@<version>` — npx downloads the package at runtime alongside live credentials. The package must be installed once with `npm install -g gmgn-cli`.
 - **Section order**: Sub-commands → Supported Chains → Prerequisites → Parameters/Options (if needed) → Usage Examples → Notes
 - **`--raw` flag**: All commands support `--raw` for single-line JSON output. Always document it in the Notes section.
 - **YAML frontmatter**: Quote `argument-hint` values that contain `|` characters to avoid YAML parsing errors.
@@ -1,8 +1,16 @@
-# gmgn-cli
+<div align="center">

-> 中文文档：[Readme.zh.md](Readme.zh.md)
+<img src="static/gmgnagentskills.png" alt="GMGN Agent Skills" />

-GMGN AI skills for on-chain operations — token research, market data, wallet analysis, and swap.
+[![X](https://img.shields.io/badge/Follow-%40gmgnai-black?logo=x&logoColor=white)](https://x.com/gmgnai) [![Telegram](https://img.shields.io/badge/Telegram-gmgnagentapi-2CA5E0?logo=telegram&logoColor=white)](https://t.me/gmgnagentapi) [![Discord](https://img.shields.io/badge/Discord-gmgnai-5865F2?logo=discord&logoColor=white)](https://discord.gg/gmgnai)
+
+English | [简体中文](Readme.zh.md)
+
+</div>
+
+## 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, and wallet management — including real-time holdings, recent P&L, and transaction history — all through natural language.

 ---

@@ -13,11 +21,212 @@ GMGN AI skills for on-chain operations — token research, market data, wallet a
 | [`/gmgn-token`](skills/gmgn-token/SKILL.md) | Token info, security, pool, holders, traders | [SKILL.md](skills/gmgn-token/SKILL.md) |
 | [`/gmgn-market`](skills/gmgn-market/SKILL.md) | K-line market data, trending tokens | [SKILL.md](skills/gmgn-market/SKILL.md) |
 | [`/gmgn-portfolio`](skills/gmgn-portfolio/SKILL.md) | Wallet holdings, activity, stats | [SKILL.md](skills/gmgn-portfolio/SKILL.md) |
+| [`/gmgn-track`](skills/gmgn-track/SKILL.md) | Follow-wallet trades, KOL trades, Smart Money trades | [SKILL.md](skills/gmgn-track/SKILL.md) |
 | [`/gmgn-swap`](skills/gmgn-swap/SKILL.md) | Swap submission + order query | [SKILL.md](skills/gmgn-swap/SKILL.md) |

+> For detailed CLI commands, parameters, and recommended values, see the [Wiki documentation](https://github.com/GMGNAI/gmgn-skills/wiki).
+
+### Quick Start
+
+Ready to install skills? [Jump to Installation →](#get-started)
+
+> **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.
+> ```
+
 ---

-## Usage Examples
+## Demo Cases
+
+### Trending Token Rankings
+
+Send this prompt to your AI Agent:
+
+```
+Fetch Solana 1h trending, filter for pump.fun tokens created within 6h, sort by volume descending.
+```
+
+![Trending Token Rankings](static/market-rank-1h-Pumpfun-en.png)
+
+### Real-Time Token Trading Analysis
+
+Send this prompt to your AI Agent:
+
+```
+Check the first token's K-line, analyze entry timing, plot price + volume chart, and provide social media links and smart money/KOL trading analysis.
+```
+
+![Token Analysis 1](static/market-tokenanalysis-en01.png)
+![Token Analysis 2](static/market-tokenanalysis-en02.png)
+
+---
+
+## Get Started
+
+Before installing, create your API Key at **https://gmgn.ai/ai**. The API key is used for:
+
+1. Read data: tokens, trending lists, K-line, and featured on-chain metrics
+2. Submit trades: market orders, limit orders, strategy orders, and more
+
+---
+
+## 1. Installation
+
+Choose one of the following methods:
+
+### 1.1 Via Agent (recommended)
+
+Send this to your AI agent:
+
+```bash
+npx skills add GMGNAI/gmgn-skills
+```
+
+### 1.2 npm Global Install
+
+```bash
+npm install -g gmgn-cli
+```
+
+### 1.3 Local Development
+
+```bash
+npm install
+npm run build
+node dist/index.js <command> [options]
+```
+
+## 2. Verify Connection
+
+### Option 1: Via AI Agent
+
+Send this prompt to your AI Agent:
+
+```
+Run this CLI command: GMGN_API_KEY=gmgn_solbscbaseethmonadtron npx gmgn-cli market trending --chain sol --interval 1h --limit 3
+```
+
+### Option 2: Via CLI
+
+Test with the public API key — no registration required:
+
+```bash
+GMGN_API_KEY=gmgn_solbscbaseethmonadtron gmgn-cli market trending --chain sol --interval 1h --limit 3
+```
+
+If you see JSON output, the CLI is working. The public key supports all read-only commands (token / market / portfolio). The public key is for testing only — apply for your own API key to use any feature (see step 3).
+
+## 3. Get Your Own API Key
+
+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:
+
+### 3.1 Generate an Ed25519 Key Pair
+
+**Option 1 — Ask your AI agent (recommended)**
+
+Send this prompt to your agent:
+
+```
+Generate an Ed25519 key pair for me using OpenSSL and show me:
+1. The public key (I need to fill it in the GMGN API Key application form)
+2. The private key in PEM format (I need to set it as GMGN_PRIVATE_KEY in my .env)
+```
+
+**Option 2 — Binance Key Generator**
+
+Download and run the [Binance Asymmetric Key Generator](https://github.com/binance/asymmetric-key-generator/releases).
+
+Enter the **public key** in the application form.
+
+### 3.2 Get Your Public Egress IP
+
+For the IP whitelist (required when enabling swap capability on your API key):
+
+```bash
+curl ip.me
+```
+
+## 4. Configure Your API Key
+
+### Option 1: Global config (recommended)
+
+Create `~/.config/gmgn/.env` once — works from any directory:
+
+```bash
+mkdir -p ~/.config/gmgn
+cat > ~/.config/gmgn/.env << 'EOF'
+GMGN_API_KEY=your_api_key_here
+
+# Required for swap / order only:
+GMGN_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n<base64>\n-----END PRIVATE KEY-----\n"
+EOF
+```
+
+### Option 2: Project `.env`
+
+```bash
+cp .env.example .env
+# Edit .env and fill in your values
+```
+
+Config lookup order: `~/.config/gmgn/.env` → project `.env` (project takes precedence).
+
+## 5. Try in AI Clients
+
+#### OpenClaw
+
+Send the following prompt directly to test the query capabilities:
+
+```
+Show me the trending tokens on Solana in the last 1 hour.
+```
+
+#### Claude Code
+
+Skills are automatically discovered when the package is installed as a plugin.
+
+#### Cursor
+
+Skills are automatically discovered via the `.cursor-plugin/` configuration.
+
+1. Complete the installation and configuration steps above
+2. Restart Cursor — skills will be available in Agent mode via `/gmgn-*` commands
+
+#### Cline
+
+1. Complete the installation and configuration steps above
+2. In Cline settings → **Skills directory**: point to the installed package's `skills/` folder:
+   ```bash
+   echo "$(npm root -g)/gmgn-skills/skills"
+   ```
+3. Restart Cline — `/gmgn-token`, `/gmgn-market`, `/gmgn-portfolio`, `/gmgn-track`, `/gmgn-swap` will be available
+
+#### Codex CLI
+
+```bash
+git clone https://github.com/GMGNAI/gmgn-skills ~/.codex/gmgn-cli
+mkdir -p ~/.agents/skills
+ln -s ~/.codex/gmgn-cli/skills ~/.agents/skills/gmgn-cli
+```
+
+See [.codex/INSTALL.md](.codex/INSTALL.md) for full instructions.
+
+#### OpenCode
+
+```bash
+git clone https://github.com/GMGNAI/gmgn-skills ~/.opencode/gmgn-cli
+mkdir -p ~/.agents/skills
+ln -s ~/.opencode/gmgn-cli/skills ~/.agents/skills/gmgn-cli
+```
+
+See [.opencode/INSTALL.md](.opencode/INSTALL.md) for full instructions.
+
+---
+
+## 6. Usage
+
+### Examples

 Natural language prompts you can send to any AI assistant with gmgn-cli skills installed:

@@ -32,118 +241,7 @@ query token details for 0x1234...
 show trading stats for wallet <wallet_address> on BSC
 ```

---
-
-## Setup
-
-### 0. Prepare
-
-Before applying for an API Key, get two things ready:
-
-**Generate an Ed25519 key pair**
-
-Download and run the [Binance Asymmetric Key Generator](https://github.com/binance/asymmetric-key-generator/releases). You will need the **public key** when filling out the API Key application, and the **private key** in your `.env` later (for swap / order).
-
-**Get your public egress IP** (for the IP whitelist)
-
-```bash
-curl ip.me
-```
-
-Or visit **https://ip.me** in your browser.
-
-### 1. Get an API Key
-
-Apply at **https://gmgn.ai/ai** — enter the public key and your IP address from the step above.
-
-### 2. Configure
-
-**Option A — Global config (recommended)**
-
-Create `~/.config/gmgn/.env` once — works from any directory:
-
-```bash
-mkdir -p ~/.config/gmgn
-cat > ~/.config/gmgn/.env << 'EOF'
-GMGN_API_KEY=your_api_key_here
-
-# Required for swap / order (private key from step 0):
-GMGN_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n<base64>\n-----END PRIVATE KEY-----\n"
-EOF
-```
-
-**Option B — Project `.env`**
-
-```bash
-cp .env.example .env
-# Edit .env and fill in your values
-```
-
-Config lookup order: `~/.config/gmgn/.env` → project `.env` (project takes precedence).
-
-### 3. CLI Install
-
-Install a pinned version to avoid pulling untrusted updates at runtime:
-
-```bash
-npm install -g gmgn-cli@1.0.1
-```
-
-Local development:
-
-```bash
-npm install
-npm run build
-node dist/index.js <command> [options]
-```
-
-### 4. Connect to Your AI Tool
-
-#### Claude Code
-
-Skills are automatically discovered when the package is installed as a plugin.
-
-#### Cursor
-
-Skills are automatically discovered via the `.cursor-plugin/` configuration.
-
-1. Complete steps 1–3 above
-2. Configure credentials in `~/.config/gmgn/.env`
-3. Restart Cursor — skills will be available in Agent mode via `/gmgn-*` commands
-
-#### Cline
-
-1. Complete steps 1–3 above
-2. In Cline settings → **Skills directory**: point to the installed package's `skills/` folder:
-   ```bash
-   echo "$(npm root -g)/gmgn-skills/skills"
-   ```
-3. Configure credentials in `~/.config/gmgn/.env`
-4. Restart Cline — `/gmgn-token`, `/gmgn-market`, `/gmgn-portfolio`, `/gmgn-swap` will be available
-
-#### Codex CLI
-
-```bash
-git clone https://github.com/gmgn-ai/gmgn-skills ~/.codex/gmgn-cli
-mkdir -p ~/.agents/skills
-ln -s ~/.codex/gmgn-cli/skills ~/.agents/skills/gmgn-cli
-```
-
-See [.codex/INSTALL.md](.codex/INSTALL.md) for full instructions.
-
-#### OpenCode
-
-```bash
-git clone https://github.com/gmgn-ai/gmgn-skills ~/.opencode/gmgn-cli
-mkdir -p ~/.agents/skills
-ln -s ~/.opencode/gmgn-cli/skills ~/.agents/skills/gmgn-cli
-```
-
-See [.opencode/INSTALL.md](.opencode/INSTALL.md) for full instructions.
-
---
-
-## Typical Workflows
+### Typical Workflows

 **Research a token:**
 ```
@@ -162,14 +260,14 @@ token info (confirm token)  →  portfolio token-balance (check funds)  →  swa

 **Discover trading opportunities via trending:**
 ```
-market trending (top 50, score-ranked)  →  AI selects top 5 by multi-factor analysis  →  user reviews  →  token info / token security  →  swap
+market trending (top 50)  →  AI selects top 5 by multi-factor analysis  →  user reviews  →  token info / token security  →  swap
 ```

 ---

-## CLI Reference
+## 7. CLI Reference

-Full parameter reference: [docs/cli-usage.md](docs/cli-usage.md)
+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'`).

 ### Token

@@ -183,8 +281,14 @@ npx gmgn-cli token info --chain sol --address <addr>
 npx gmgn-cli market trending \
  --chain sol \
  --interval 1h \
-  --orderby volume --limit 20 \
+  --order-by volume --limit 20 \
  --filter not_risk --filter not_honeypot
+
+npx gmgn-cli market trenches \
+  --chain sol \
+  --type new_creation --type near_completion --type completed \
+  --launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform letsbonk \
+  --limit 80
 ```

 ### Portfolio
@@ -193,10 +297,26 @@ npx gmgn-cli market trending \
 npx gmgn-cli portfolio holdings --chain sol --wallet <addr>
 ```

+### Track
+
+```bash
+# Follow-wallet trade records (requires GMGN_PRIVATE_KEY)
+npx gmgn-cli track follow-wallet --chain sol
+npx gmgn-cli track follow-wallet --chain sol --wallet <wallet_address> --side buy
+
+# KOL trade records
+npx gmgn-cli track kol --limit 100 --raw
+npx gmgn-cli track kol --chain sol --side buy --limit 50 --raw
+
+# Smart Money trade records
+npx gmgn-cli track smartmoney --limit 100 --raw
+npx gmgn-cli track smartmoney --chain sol --side sell --limit 50 --raw
+```
+
 ### Swap (requires private key)

 ```bash
-# Submit swap
+# Submit swap with fixed slippage
 npx gmgn-cli swap \
  --chain sol \
  --from <wallet-address> \
@@ -205,32 +325,61 @@ npx gmgn-cli swap \
  --amount 1000000 \
  --slippage 0.01

+# Submit swap with automatic slippage
+npx gmgn-cli swap \
+  --chain sol \
+  --from <wallet-address> \
+  --input-token <input-token-addr> \
+  --output-token <output-token-addr> \
+  --amount 1000000 \
+  --auto-slippage
+
 # Query order
 npx gmgn-cli order get --chain sol --order-id <order-id>
 ```

---
-
-## Supported Chains
+## 8. Supported Chains

 | Commands | Chains | Chain Currencies |
 |----------|--------|-----------------|
-| token / market / portfolio | `sol` / `bsc` / `base` | — |
+| token / market / portfolio / track | `sol` / `bsc` / `base` | — |
 | swap / order | `sol` / `bsc` / `base` | sol: SOL, USDC · bsc: BNB, USDC · base: ETH, USDC |

 ---

-## Output Format
+## 9. Upgrade Skills and CLI

-Default: formatted JSON. Use `--raw` for single-line JSON (pipe-friendly):
+To upgrade `gmgn-cli` and Skills to the latest version:
+
+**Via AI Agent (recommended)**
+
+Send this to your AI agent:
+
+```
+Run these two commands to update gmgn-cli and the skills:
+1. npm install -g gmgn-cli
+2. npx skills add GMGNAI/gmgn-skills
+```
+
+**Via CLI**

 ```bash
-npx gmgn-cli token info --chain sol --address <addr> --raw | jq '.price'
+# Upgrade gmgn-cli
+npm install -g gmgn-cli
+
+# Upgrade Skills
+npx skills add GMGNAI/gmgn-skills
+```
+
+**Check the current version**
+
+```bash
+gmgn-cli --version
 ```

 ---

-## Security & Disclaimer
+## 10. Security & Disclaimer

 **About `GMGN_PRIVATE_KEY`**

@@ -241,7 +390,7 @@ npx gmgn-cli token info --chain sol --address <addr> --raw | jq '.price'
 - Restrict config file permissions: `chmod 600 ~/.config/gmgn/.env`
 - Never commit your `.env` file to version control — add it to `.gitignore`
 - Do not share `GMGN_API_KEY` or `GMGN_PRIVATE_KEY` in logs, screenshots, or chat messages
- Use a pinned install (`npm install -g gmgn-cli@1.0.1`) rather than `npx gmgn-cli` to avoid executing unintended package updates alongside your credentials
+- Always use the latest version of gmgn-cli (`npm install -g gmgn-cli`). To check your current version: `gmgn-cli --version`

 **Disclaimer**

@@ -1,8 +1,16 @@
-# gmgn-cli
+<div align="center">

-> English: [Readme.md](Readme.md)
+<img src="static/gmgnagentskills.png" alt="GMGN Agent Skills" />

-GMGN 链上操作 AI 技能套件 — Token 研究、行情数据、钱包分析和交易。
+[![X](https://img.shields.io/badge/关注-%40gmgnai-black?logo=x&logoColor=white)](https://x.com/gmgnai) [![Telegram](https://img.shields.io/badge/Telegram-gmgnagentapi-2CA5E0?logo=telegram&logoColor=white)](https://t.me/gmgnagentapi) [![Discord](https://img.shields.io/badge/Discord-gmgnai-5865F2?logo=discord&logoColor=white)](https://discord.gg/gmgnai)
+
+[English](Readme.md) | 简体中文
+
+</div>
+
+## GMGN Agent Skills
+
+使用 GMGN Agent Skills，你可以通过 AI Agent 实时查询多个链上热门代币排行榜，代币基础信息，社交媒体信息，实时交易动态，实时战壕新币，报持仓大户（Top Holder），交易大户（Top Trader），聪明钱持仓占比，KOL持仓占比，老鼠仓持仓，捆绑持仓占比，等代币专业数据分析数据，以及支持代币市价单交易、限价单交易、高级止盈止损策略单交易，以及钱包资产管理相关功能，例如查询钱包实时持仓、钱包最近盈亏、钱包交易动态等，全部通过自然语言与 AI Agent 交互即可完成。

 ---

@@ -13,52 +21,135 @@ GMGN 链上操作 AI 技能套件 — Token 研究、行情数据、钱包分析
 | [`/gmgn-token`](skills/gmgn-token/SKILL.md) | Token 信息、安全、池子、持有者、交易者 | [SKILL.md](skills/gmgn-token/SKILL.md) |
 | [`/gmgn-market`](skills/gmgn-market/SKILL.md) | K 线行情数据、热门代币 | [SKILL.md](skills/gmgn-market/SKILL.md) |
 | [`/gmgn-portfolio`](skills/gmgn-portfolio/SKILL.md) | 钱包持仓、活动、统计 | [SKILL.md](skills/gmgn-portfolio/SKILL.md) |
+| [`/gmgn-track`](skills/gmgn-track/SKILL.md) | 追踪关注钱包交易动态、KOL 交易动态、聪明钱交易动态 | [SKILL.md](skills/gmgn-track/SKILL.md) |
 | [`/gmgn-swap`](skills/gmgn-swap/SKILL.md) | 兑换提交 + 订单查询 | [SKILL.md](skills/gmgn-swap/SKILL.md) |

---
+> 如需查看详细的 CLI 接口说明、传参格式和推荐值，请参阅 [Wiki 文档](https://github.com/GMGNAI/gmgn-skills/wiki/Home-Chinese)。

-## 用法示例
+### 快速开始安装

-安装技能后，向 AI 助手直接发送自然语言指令：
+已准备好？[点击这里开始安装 Skills →](#开始安装-skills)

-```
-buy 0.1 SOL of <token_address>
-sell 50% of <token_address> on BSC
-check order status <order_id>
-is <token_address> safe to buy on solana?
-show top holders of <token_address>
-show my wallet holdings on SOL
-query token details for 0x1234...
-show trading stats for wallet <wallet_address> on BSC
-```
+> **提示：** 如果你的 AI Agent 尝试直接打开 gmgn.ai 网站而不是使用 CLI，请在提示词中加上：
+> ```
+> 用 gmgn-cli 命令，不要直接请求gmgn.ai网页接口。
+> ```

 ---

-## 安装配置
+## 使用案例

-### 0. 准备工作
+### 查询热门代币榜

-申请 API Key 前，需要先准备两件事：
+发送下面提示词给 AI Agent：

-**生成 Ed25519 密钥对**
+```
+查 Solana 1h 热门榜，筛出 6 小时内创建的新币，并且platforms是pump.fun的代币，然后按交易量从高到低排列。
+```

-下载并运行 [Binance Asymmetric Key Generator](https://github.com/binance/asymmetric-key-generator/releases)。申请 API Key 时需要填入**公钥**，**私钥**稍后配置到 `.env`（swap / order 接口使用）。
+![查询热门代币榜](static/market-rank-1h-Pumpfun-cn.png)

-**获取本机出口 IP**（用于填写 IP 白名单）
+### 实时分析代币交易走势
+
+发送下面提示词给 AI Agent：
+
+```
+查看第一个代币的 K 线，分析入场时机，并提供社交媒体链接以及聪明资金 / KOL 的交易分析。
+```
+
+![代币分析 1](static/market-tokenanalysis-cn01.png)
+![代币分析 2](static/market-tokenanalysis-cn02.png)
+
+---
+
+## 开始安装 Skills
+
+安装前，请先在 **https://gmgn.ai/ai** 创建 API Key，用于：
+
+1. 读取数据：代币、榜单、K 线、特色数据指标
+2. 提交交易：市价立即交易、创建限价单、策略单等
+
+---
+
+## 1. 安装
+
+选择以下任意一种方式
+
+### 1.1 通过 Agent 安装（推荐）
+
+发送给你的 AI Agent：
+
+```bash
+npx skills add GMGNAI/gmgn-skills
+```
+
+### 1.2 npm 全局安装
+
+```bash
+npm install -g gmgn-cli
+```
+
+### 1.3 本地开发
+
+```bash
+npm install
+npm run build
+node dist/index.js <command> [options]
+```
+
+## 2. 验证连通性
+
+### 方式一：通过 AI Agent 验证
+
+发送以下提示词给你的 AI Agent：
+
+```
+执行这个cli命令：GMGN_API_KEY=gmgn_solbscbaseethmonadtron npx gmgn-cli market trending --chain sol --interval 1h --limit 3
+```
+
+### 方式二：通过 CLI 验证
+
+使用公共 API Key 测试，无需注册：
+
+```bash
+GMGN_API_KEY=gmgn_solbscbaseethmonadtron npx gmgn-cli market trending --chain sol --interval 1h --limit 3
+```
+
+看到 JSON 输出即表示 CLI 正常工作。公共 Key 支持所有只读接口（token / market / portfolio），公共 Key 仅用于测试，正式使用任何接口均需申请个人 API Key（见第 3 步）。
+
+## 3. 申请个人 API Key
+
+第 2 步的公共 Key 仅用于测试。正式使用（只读接口和 swap）均需在 https://gmgn.ai/ai 申请个人 API Key，需要准备：
+
+### 3.1 生成 Ed25519 密钥对
+
+**方式一：输入提示词（推荐）**
+
+将以下提示词发送给你的 AI Agent：
+
+```
+帮我用 OpenSSL 生成一个 Ed25519 密钥对，并分别显示给我：
+1. 公钥（我需要填写到GMGN网站上的 API Key 创建表单中）
+2. PEM 格式的私钥（我需要将它设置为 .env 中的 GMGN_PRIVATE_KEY）
+```
+
+**方式二：Binance Key Generator**
+
+下载并运行 [Binance Asymmetric Key Generator](https://github.com/binance/asymmetric-key-generator/releases)。
+
+申请时填入**公钥**。
+
+### 3.2 获取本机出口 IP
+
+用于填写 IP 白名单（开通 API Key 的交易能力时需要）：

 ```bash
 curl ip.me
 ```

-或在浏览器访问 **https://ip.me**。
+## 4. 配置个人 API Key

-### 1. 获取 API Key
-
-申请地址：**https://gmgn.ai/ai** — 填入上一步准备好的公钥和 IP 地址。
-
-### 2. 配置
-
-**方式 A — 全局配置（推荐）**
+### 方式一：全局配置（推荐）

 创建 `~/.config/gmgn/.env`，配置一次，所有目录均生效：

@@ -67,12 +158,12 @@ mkdir -p ~/.config/gmgn
 cat > ~/.config/gmgn/.env << 'EOF'
 GMGN_API_KEY=your_api_key_here

-# swap / order 接口额外需要（第 0 步生成的私钥）：
+# 仅 swap / order 接口需要：
 GMGN_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n<base64>\n-----END PRIVATE KEY-----\n"
 EOF
 ```

-**方式 B — 项目 `.env`**
+### 方式二：项目 `.env`

 ```bash
 cp .env.example .env
@@ -81,24 +172,16 @@ cp .env.example .env

 配置加载顺序：`~/.config/gmgn/.env` → 项目 `.env`（项目级优先）。

-### 3. CLI 安装
+## 5. 在 AI 客户端中使用

-安装固定版本，避免运行时拉取未经验证的更新：
+#### OpenClaw
+
+直接发送以下提示词，测试查询能力：

-```bash
-npm install -g gmgn-cli@1.0.1
 ```
-
-本地开发：
-
-```bash
-npm install
-npm run build
-node dist/index.js <command> [options]
+查询 Solana 链 1 小时热门代币
 ```

-### 4. 接入 AI 工具
-
 #### Claude Code

 安装包后通过插件机制自动发现技能。
@@ -107,24 +190,22 @@ node dist/index.js <command> [options]

 技能通过 `.cursor-plugin/` 配置自动发现。

-1. 完成上方步骤 1–3
-2. 配置凭证：`~/.config/gmgn/.env`
-3. 重启 Cursor — Agent 模式下可通过 `/gmgn-*` 命令使用技能
+1. 完成上方安装和配置步骤
+2. 重启 Cursor — Agent 模式下可通过 `/gmgn-*` 命令使用技能

 #### Cline

-1. 完成上方步骤 1–3
+1. 完成上方安装和配置步骤
 2. 在 Cline 设置 → **Skills directory**：填入已安装包的 `skills/` 目录路径：
   ```bash
   echo "$(npm root -g)/gmgn-skills/skills"
   ```
-3. 配置凭证：`~/.config/gmgn/.env`
-4. 重启 Cline — `/gmgn-token`、`/gmgn-market`、`/gmgn-portfolio`、`/gmgn-swap` 即可使用
+3. 重启 Cline — `/gmgn-token`、`/gmgn-market`、`/gmgn-portfolio`、`/gmgn-track`、`/gmgn-swap` 即可使用

 #### Codex CLI

 ```bash
-git clone https://github.com/gmgn-ai/gmgn-skills ~/.codex/gmgn-cli
+git clone https://github.com/GMGNAI/gmgn-skills ~/.codex/gmgn-cli
 mkdir -p ~/.agents/skills
 ln -s ~/.codex/gmgn-cli/skills ~/.agents/skills/gmgn-cli
 ```
@@ -134,7 +215,7 @@ ln -s ~/.codex/gmgn-cli/skills ~/.agents/skills/gmgn-cli
 #### OpenCode

 ```bash
-git clone https://github.com/gmgn-ai/gmgn-skills ~/.opencode/gmgn-cli
+git clone https://github.com/GMGNAI/gmgn-skills ~/.opencode/gmgn-cli
 mkdir -p ~/.agents/skills
 ln -s ~/.opencode/gmgn-cli/skills ~/.agents/skills/gmgn-cli
 ```
@@ -143,60 +224,151 @@ ln -s ~/.opencode/gmgn-cli/skills ~/.agents/skills/gmgn-cli

 ---

-## 典型使用场景
+## 6. 使用示例
+
+### 常用指令
+
+安装技能后，向 AI 助手直接发送自然语言指令：
+
+```
+用 0.1 SOL 买入 <token_address>
+卖出 BSC 上 <token_address> 的 50%
+把我持有的 <token_address> 卖掉 30%
+查询报价，我想用 1 SOL 换 <token_address>，能换多少
+查询订单状态 <order_id>
+solana 上的 <token_address> 安全吗，值得买入吗？
+查看 <token_address> 的前十大持有者
+查看 <token_address> 的聪明钱持仓，按买入量排序
+查看 <token_address> 最近的 KOL 交易动态
+查看我在 SOL 上的钱包持仓
+查询 0x1234... 的代币详情
+查看 <token_address> 过去 24 小时的 K 线和交易量
+查看 BSC 上钱包 <wallet_address> 的交易统计
+查看钱包 <wallet_address> 最近的交易记录
+我的 API Key 绑定了哪些钱包，余额各是多少
+查看 SOL 链上最新的聪明钱交易动态
+查看 SOL 链上 KOL 最近在买什么
+查询 Solana 上最新发布的代币
+查询 Solana 1 分钟交易热门代币
+```
+
+### 典型使用场景

 **研究 Token：**
 ```
-token info  →  token security  →  token pool  →  token holders
+查询代币信息  →  查询安全指标  →  查询流动池  →  查询持有者
 ```

 **分析钱包：**
 ```
-portfolio holdings  →  portfolio stats  →  portfolio activity
+查询钱包持仓  →  查询交易统计  →  查询交易记录
 ```

 **执行交易：**
 ```
-token info（确认 Token）  →  portfolio token-balance（检查余额）  →  swap  →  order get（轮询状态）
+确认代币信息  →  检查余额  →  提交兑换  →  轮询订单状态
 ```

-**通过 Trending 发现交易机会：**
+**通过热门榜单发现交易机会：**
 ```
-market trending（取 50 条，按 score 排序）  →  AI 多维度分析选出 top 5  →  用户确认  →  token info / token security  →  swap
+获取热门代币（50 条）  →  AI 多维度分析选出 top 5  →  用户确认  →  查询代币信息 / 安全指标  →  提交兑换
 ```

 ---

-## CLI 参考
+## 7. CLI 参考

-完整参数说明：[docs/cli-usage.md](docs/cli-usage.md)
+完整参数说明：[docs/cli-usage.md](docs/cli-usage.md)。所有命令均支持 `--raw` 输出单行 JSON（方便 `jq` 等工具处理）。

 ### Token

 ```bash
+# 基本信息 + 实时价格
 npx gmgn-cli token info --chain sol --address <addr>
+
+# 安全指标（蜜罐、税率、集中度、rug 风险）
+npx gmgn-cli token security --chain sol --address <addr>
+
+# 流动池信息（DEX、储备量、深度）
+npx gmgn-cli token pool --chain sol --address <addr>
+
+# 持仓大户（按持仓比例排序）
+npx gmgn-cli token holders --chain sol --address <addr> --limit 50
+
+# 聪明钱持仓大户（按买入量排序）
+npx gmgn-cli token holders --chain sol --address <addr> \
+  --tag smart_degen --order-by buy_volume_cur --limit 20
+
+# 交易大户（KOL，按已实现盈利排序）
+npx gmgn-cli token traders --chain sol --address <addr> \
+  --tag renowned --order-by profit --limit 20
 ```

 ### Market

 ```bash
+# K 线数据（1h 周期，最近 24 小时）
+# macOS:
+npx gmgn-cli market kline \
+  --chain sol --address <addr> \
+  --resolution 1h \
+  --from $(date -v-24H +%s) --to $(date +%s)
+# Linux: $(date -d '24 hours ago' +%s)
+
+# 热门代币榜（SOL，1h，按交易量排序）
 npx gmgn-cli market trending \
  --chain sol \
  --interval 1h \
-  --orderby volume --limit 20 \
+  --order-by volume --limit 20 \
  --filter not_risk --filter not_honeypot
+
+# 战壕新币列表
+npx gmgn-cli market trenches \
+  --chain sol \
+  --type new_creation --type near_completion --type completed \
+  --launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform letsbonk \
+  --limit 80
 ```

 ### Portfolio

 ```bash
+# 钱包持仓
 npx gmgn-cli portfolio holdings --chain sol --wallet <addr>
+
+# 交易记录
+npx gmgn-cli portfolio activity --chain sol --wallet <addr>
+
+# 交易统计（支持多钱包）
+npx gmgn-cli portfolio stats --chain sol --wallet <addr1> --wallet <addr2>
+
+# API Key 绑定的钱包及主币余额
+npx gmgn-cli portfolio info
+
+# 单个 token 余额
+npx gmgn-cli portfolio token-balance --chain sol --wallet <addr> --token <token_addr>
+```
+
+### Track
+
+```bash
+# 追踪关注钱包的交易动态（需要 GMGN_PRIVATE_KEY）
+npx gmgn-cli track follow-wallet --chain sol
+npx gmgn-cli track follow-wallet --chain sol --wallet <wallet_address> --side buy
+
+# KOL 交易动态
+npx gmgn-cli track kol --limit 100 --raw
+npx gmgn-cli track kol --chain sol --side buy --limit 50 --raw
+
+# 聪明钱交易动态
+npx gmgn-cli track smartmoney --limit 100 --raw
+npx gmgn-cli track smartmoney --chain sol --side sell --limit 50 --raw
 ```

 ### Swap（需要私钥）

 ```bash
-# 提交兑换
+# 提交兑换（固定滑点）
 npx gmgn-cli swap \
  --chain sol \
  --from <wallet-address> \
@@ -205,32 +377,79 @@ npx gmgn-cli swap \
  --amount 1000000 \
  --slippage 0.01

-# 查询订单
+# 提交兑换（自动滑点）
+npx gmgn-cli swap \
+  --chain sol \
+  --from <wallet-address> \
+  --input-token <input-token-addr> \
+  --output-token <output-token-addr> \
+  --amount 1000000 \
+  --auto-slippage
+
+# 按持仓比例卖出（例：卖出 50%）
+npx gmgn-cli swap \
+  --chain sol \
+  --from <wallet-address> \
+  --input-token <token-addr> \
+  --output-token <usdc-addr> \
+  --percent 50 \
+  --auto-slippage
+
+# 获取报价（不提交交易）
+npx gmgn-cli order quote \
+  --chain sol \
+  --from <wallet-address> \
+  --input-token <input-token-addr> \
+  --output-token <output-token-addr> \
+  --amount 1000000 \
+  --slippage 0.01
+
+# 查询订单状态
 npx gmgn-cli order get --chain sol --order-id <order-id>
 ```

---
-
-## 支持的链
+## 8. 支持的链

 | 接口类型 | 支持的链 | 链原生货币 |
 |----------|----------|-----------|
-| token / market / portfolio | `sol` / `bsc` / `base` | — |
+| token / market / portfolio / track | `sol` / `bsc` / `base` | — |
 | swap / order | `sol` / `bsc` / `base` | sol: SOL、USDC · bsc: BNB、USDC · base: ETH、USDC |

 ---

-## 输出格式
+## 9. 升级 Skills 和 CLI

-默认输出格式化 JSON。使用 `--raw` 输出单行 JSON（方便 jq 等工具处理）：
+将 `gmgn-cli` 和 Skills 升级到最新版本：
+
+**方式一：通过 AI Agent（推荐）**
+
+发送给你的 AI Agent：
+
+```
+运行以下两条命令，更新 gmgn-cli 和 Skills 文档：
+1. npm install -g gmgn-cli
+2. npx skills add GMGNAI/gmgn-skills
+```
+
+**方式二：通过 CLI**

 ```bash
-npx gmgn-cli token info --chain sol --address <addr> --raw | jq '.price'
+# 升级 gmgn-cli
+npm install -g gmgn-cli
+
+# 升级 Skills
+npx skills add GMGNAI/gmgn-skills
+```
+
+**查看当前版本号**
+
+```bash
+gmgn-cli --version
 ```

 ---

-## 安全与免责
+## 10. 安全与免责

 **关于 `GMGN_PRIVATE_KEY`**

@@ -241,7 +460,7 @@ npx gmgn-cli token info --chain sol --address <addr> --raw | jq '.price'
 - 限制配置文件权限：`chmod 600 ~/.config/gmgn/.env`
 - 不要将 `.env` 文件提交到版本控制系统，请将其加入 `.gitignore`
 - 不要在日志、截图或聊天中泄露 `GMGN_API_KEY` 或 `GMGN_PRIVATE_KEY`
- 使用固定版本安装（`npm install -g gmgn-cli@1.0.1`），而非 `npx gmgn-cli`，以避免在持有凭证的环境中执行未预期的包更新
+- 请使用最新的 gmgn-cli（`npm install -g gmgn-cli`），查看当前版本请使用 `gmgn-cli --version`。

 **免责声明**

@@ -116,7 +116,7 @@ npx gmgn-cli market trending \
  --chain <chain> \
  --interval <interval> \
  [--limit <n>] \
-  [--orderby <field>] \
+  [--order-by <field>] \
  [--direction asc|desc] \
  [--filter <tag>] \
  [--platform <name>] \
@@ -128,10 +128,16 @@ npx gmgn-cli market trending \
 | `--chain` | Yes | `sol` / `bsc` / `base` |
 | `--interval` | Yes | `1h` / `3h` / `6h` / `24h` |
 | `--limit` | No | Number of results (default 100, max 100) |
-| `--orderby` | No | Sort field: `score` / `volume` / `swaps` / `liquidity` / `marketcap` / `holders` / `price` / `change` / `change1m` / `change5m` / `change1h` / `renowned_count` / `smart_degen_count` / `bluechip_owner_percentage` / `rank` / `creation_timestamp` / `square_mentions` / `history_highest_market_cap` / `gas_fee` |
+| `--order-by` | No | Sort field: `volume` / `swaps` / `liquidity` / `marketcap` / `holders` / `price` / `change` / `change1m` / `change5m` / `change1h` / `renowned_count` / `smart_degen_count` / `bluechip_owner_percentage` / `rank` / `creation_timestamp` / `square_mentions` / `history_highest_market_cap` / `gas_fee` |
 | `--direction` | No | Sort direction: `asc` / `desc` (default `desc`) |
 | `--filter` | No | Filter tag (repeatable): `has_social` / `not_risk` / `not_honeypot` / `verified` / `locked` / `renounced` / `distributed` / `frozen` / `burn` / `token_burnt` / `creator_hold` / `creator_close` / `creator_add_liquidity` / `creator_remove_liquidity` / `creator_sell` / `creator_buy` / `not_wash_trading` / `not_social_dup` / `not_image_dup` / `is_internal_market` / `is_out_market` |
-| `--platform` | No | Platform filter (repeatable): `pump` / `moonshot` / `launchlab` |
+| `--platform` | No | Platform filter (repeatable). Omit (or pass an empty list) to include **all** platforms. Available values depend on chain — see below. |
+
+**`sol` platforms:** `Pump.fun` / `pump_mayhem` / `pump_mayhem_agent` / `pump_agent` / `letsbonk` / `bonkers` / `bags` / `memoo` / `liquid` / `bankr` / `zora` / `surge` / `anoncoin` / `moonshot_app` / `wendotdev` / `heaven` / `sugar` / `token_mill` / `believe` / `trendsfun` / `trends_fun` / `jup_studio` / `Moonshot` / `boop` / `xstocks` / `ray_launchpad` / `meteora_virtual_curve` / `pool_ray` / `pool_meteora` / `pool_pump_amm` / `pool_orca`
+
+**`bsc` platforms:** `fourmeme` / `fourmeme_agent` / `bn_fourmeme` / `flap` / `clanker` / `lunafun` / `pool_uniswap` / `pool_pancake`
+
+**`base` platforms:** `clanker` / `bankr` / `flaunch` / `zora` / `zora_creator` / `baseapp` / `basememe` / `virtuals_v2` / `klik`

 ---

@@ -249,6 +255,130 @@ npx gmgn-cli portfolio token-balance \

 ---

+## market trenches
+
+Query Trenches token lists (new creation, near completion, completed).
+
+```bash
+npx gmgn-cli market trenches --chain <chain> [--type <type...>] [--launchpad-platform <platform...>] [--limit <n>] [--raw]
+```
+
+| Option | Required | Description |
+|--------|----------|-------------|
+| `--chain` | Yes | `sol` / `bsc` / `base` |
+| `--type` | No | Categories to query, repeatable: `new_creation` / `near_completion` / `completed` (default: all three) |
+| `--launchpad-platform` | No | Launchpad platform filter, repeatable (default: all platforms for the chain) |
+| `--limit` | No | Max results per category, max 80 (default: 80) |
+
+**Response:** `data.new_creation`, `data.pump`, `data.completed` — each is an array of `RankItem` (same structure as `market trending` rank items). **Note: `data.pump` in the response corresponds to `--type near_completion` in the request. The API always returns this category under the key `pump`, not `near_completion`.**
+
+---
+
+## portfolio follow-wallet
+
+Query follow-wallet trade records.
+
+```bash
+npx gmgn-cli portfolio follow-wallet \
+  --chain <chain> \
+  [--wallet <wallet_address>] \
+  [--base-token <token_address>] \
+  [--page-token <cursor>] \
+  [--limit <n>] \
+  [--side <side>] \
+  [--cost <cost>] \
+  [--filter <tag>] \
+  [--with-balance] \
+  [--with-security] \
+  [--min-amount-usd <n>] \
+  [--max-amount-usd <n>] \
+  [--is-gray] \
+  [--raw]
+```
+
+| Option | Required | Description |
+|--------|----------|-------------|
+| `--chain` | Yes | `sol` / `bsc` / `base` / `eth` |
+| `--wallet` | No | Filter by wallet address |
+| `--base-token` | No | Filter by base token address |
+| `--page-token` | No | Pagination cursor |
+| `--limit` | No | Page size (1–200, default 100) |
+| `--side` | No | Trade direction filter |
+| `--cost` | No | Cost filter |
+| `--filter` | No | Filter conditions (repeatable) |
+| `--with-balance` | No | Include balance in response |
+| `--with-security` | No | Include security info in response |
+| `--min-amount-usd` | No | Minimum trade amount (USD) |
+| `--max-amount-usd` | No | Maximum trade amount (USD) |
+| `--is-gray` | No | Gray mode filter |
+
+---
+
+## portfolio kol
+
+Query KOL trade records (SOL chain).
+
+```bash
+npx gmgn-cli portfolio kol [--limit <n>] [--raw]
+```
+
+| Option | Required | Description |
+|--------|----------|-------------|
+| `--limit` | No | Page size (1–200, default 100) |
+
+---
+
+## portfolio smartmoney
+
+Query Smart Money trade records (SOL chain).
+
+```bash
+npx gmgn-cli portfolio smartmoney [--limit <n>] [--raw]
+```
+
+| Option | Required | Description |
+|--------|----------|-------------|
+| `--limit` | No | Page size (1–200, default 100) |
+
+---
+
+## order quote
+
+Get a swap quote without submitting a transaction. Uses normal auth — no private key required.
+
+```bash
+npx gmgn-cli order quote \
+  --chain <chain> \
+  --from <wallet_address> \
+  --input-token <input_token_address> \
+  --output-token <output_token_address> \
+  --amount <input_amount> \
+  --slippage <n> \
+  [--raw]
+```
+
+| Option | Required | Description |
+|--------|----------|-------------|
+| `--chain` | Yes | `sol` / `bsc` / `base` |
+| `--from` | Yes | Wallet address (must match API Key binding) |
+| `--input-token` | Yes | Input token contract address |
+| `--output-token` | Yes | Output token contract address |
+| `--amount` | Yes | Input amount (smallest unit) |
+| `--slippage` | Yes | Slippage tolerance, e.g. `0.01` = 1% |
+
+**Response fields (data):**
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `input_token` | string | Input token contract address |
+| `output_token` | string | Output token contract address |
+| `input_amount` | string | Input amount (smallest unit) |
+| `output_amount` | string | Expected output amount (smallest unit) |
+| `min_output_amount` | string | Minimum output after slippage |
+| `slippage` | number | Actual slippage percentage |
+
+---
+
 ## swap

 Submit a token swap. **Requires `GMGN_PRIVATE_KEY` configured in `.env`.**
@@ -261,6 +391,7 @@ npx gmgn-cli swap \
  --output-token <output_token_address> \
  [--amount <input_amount> | --percent <pct>] \
  [--slippage <n>] \
+  [--auto-slippage] \
  [--min-output <amount>] \
  [--anti-mev] \
  [--priority-fee <sol>] \
@@ -281,6 +412,7 @@ npx gmgn-cli swap \
 | `--amount` | No* | Input raw amount in minimal unit (e.g., lamports for SOL); required unless `--percent` is used |
 | `--percent` | No* | Input amount as a percentage, e.g. `50` = 50%; required unless `--amount` is used; only valid when input token is not a currency (not SOL/BNB/ETH/USDC) |
 | `--slippage` | No | Slippage tolerance, e.g. `0.01` = 1% |
+| `--auto-slippage` | No | Enable automatic slippage |
 | `--min-output` | No | Minimum output amount (raw amount) |
 | `--anti-mev` | No | Enable anti-MEV protection (default true) |
 | `--priority-fee` | No | Priority fee in SOL (≥ 0.00001 SOL, SOL only) |
@@ -1,12 +1,12 @@
 {
  "name": "gmgn-cli",
-  "version": "1.0.0",
+  "version": "1.1.5",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "gmgn-cli",
-      "version": "1.0.0",
+      "version": "1.1.5",
      "license": "MIT",
      "dependencies": {
        "commander": "^12.1.0",
@@ -1,6 +1,6 @@
 {
  "name": "gmgn-cli",
-  "version": "1.0.1",
+  "version": "1.1.5",
  "description": "GMGN OpenAPI CLI — call GMGN market, token, portfolio and swap APIs from the command line",
  "type": "module",
  "bin": {
@@ -16,7 +16,7 @@
  "scripts": {
    "build": "tsc",
    "dev": "tsx src/index.ts",
-"prepublishOnly": "npm run build",
+    "prepublishOnly": "npm run build",
    "publish:provenance": "npm publish --provenance --access public"
  },
  "dependencies": {
@@ -36,7 +36,7 @@
  "license": "MIT",
  "repository": {
    "type": "git",
-    "url": "https://github.com/gmgn-ai/gmgn-skills"
+    "url": "https://github.com/GMGNAI/gmgn-skills"
  },
  "keywords": [
    "gmgn",
@@ -1,17 +1,20 @@
 ---
 name: gmgn-market
-description: Query GMGN market data — token K-line (candlestick) and trending token swap data. Supports sol / bsc / base.
-argument-hint: "kline --chain <sol|bsc|base> --address <token_address> --resolution <1m|5m|15m|1h|4h|1d> [--from <unix_ts>] [--to <unix_ts>] | trending --chain <sol|bsc|base> --interval <1h|3h|6h|24h>"
+description: Query GMGN market data — token K-line (candlestick), trending token swap data, and Trenches token lists. Supports sol / bsc / base.
+argument-hint: "kline --chain <sol|bsc|base> --address <token_address> --resolution <1m|5m|15m|1h|4h|1d> [--from <unix_ts>] [--to <unix_ts>] | trending --chain <sol|bsc|base> --interval <1m|5m|1h|6h|24h> | trenches --chain <sol|bsc|base>"
 ---

-Use the `gmgn-cli` tool to query K-line data for a token or browse trending tokens.
+**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.**
+
+Use the `gmgn-cli` tool to query K-line data for a token, browse trending tokens, or view Trenches token lists.

 ## Sub-commands

 | Sub-command | Description |
 |-------------|-------------|
-| `market kline` | Token candlestick data |
-| `market trending` | Trending token swap data |
+| `market kline` | Token candlestick / OHLCV data and trading volume over a time range |
+| `market trending` | Trending tokens ranked by swap activity — use `--interval` to specify the time window (e.g. `1m` for 1-minute hottest, `1h` for 1-hour trending) |
+| `market trenches` | Newly launched launchpad paltform tokens — **use this when the user asks for "new tokens", "just launched tokens", "latest tokens on pump.fun/letsbonk"**. Three categories: `new_creation` (just created), `near_completion` (bonding curve almost full), `completed` (graduated to open market / DEX) |

 ## Supported Chains

@@ -21,36 +24,67 @@ Use the `gmgn-cli` tool to query K-line data for a token or browse trending toke

 - `.env` file with `GMGN_API_KEY` set
 - Run from the directory where your `.env` file is located, or set `GMGN_HOST` in your environment
- `gmgn-cli` installed globally: `npm install -g gmgn-cli@1.0.1`
+- `gmgn-cli` installed globally: `npm install -g gmgn-cli`

-## Kline Parameters
+## `market kline` Parameters

 | Parameter | Required | Description |
 |-----------|----------|-------------|
 | `--chain` | Yes | `sol` / `bsc` / `base` |
 | `--address` | Yes | Token contract address |
-| `--resolution` | Yes | Candlestick resolution |
+| `--resolution` | Yes | Candlestick resolution: `1m` / `5m` / `15m` / `1h` / `4h` / `1d` |
 | `--from` | No | Start time (Unix seconds) |
 | `--to` | No | End time (Unix seconds) |

-## Resolutions
+## `market kline` Response Fields

-`1m` / `5m` / `15m` / `1h` / `4h` / `1d`
+The response is an object with a `list` array. Each element in `list` is one candlestick:

-## Trending Options
+| Field | Type | Description |
+|-------|------|-------------|
+| `time` | number | Candle open time — Unix timestamp in **milliseconds** (divide by 1000 for seconds) |
+| `open` | string | Opening price in USD at the start of the period |
+| `close` | string | Closing price in USD at the end of the period |
+| `high` | string | Highest price in USD during the period |
+| `low` | string | Lowest price in USD during the period |
+| `volume` | string | Trading volume in **USD** (dollar value of all trades in this period) |
+| `amount` | string | Trading volume in **base token units** (number of tokens traded) |
+
+**Important distinctions (naming is counterintuitive — do not guess):**
+- `volume` = USD dollar value (e.g. `1214` means ~$1,214 traded) — use this for "how much was traded in USD"
+- `amount` = token count (e.g. `5379110` means ~5.38M tokens changed hands) — use this for "how many tokens were traded"
+- For tokens not priced at $1, `volume` and `amount` will differ by orders of magnitude (e.g. a $0.0002 token: $1,214 volume = 5,379,110 tokens)
+- To get **total USD volume over a time range**, sum `volume` across all candles in the range
+- To get **price trend**, read `close` values in chronological order (`time` ascending)
+- To detect **volatility**, compare `high` vs `low` within each candle
+- Candles are returned in chronological order (oldest first)
+
+## `market trending` Options
+
+**`--interval` selection guide — always match to the user's stated time window:**
+
+| User says | `--interval` |
+|-----------|-------------|
+| "1分钟热门" / "1m trending" / "hottest right now" | `1m` |
+| "5分钟" / "5m" | `5m` |
+| "1小时" / "1h" / no time specified (default) | `1h` |
+| "6小时" / "6h" | `6h` |
+| "24小时" / "今日" / "daily" | `24h` |

 | Option | Description |
 |--------|-------------|
 | `--chain` | Required. `sol` / `bsc` / `base` |
-| `--interval` | Required. `1h` / `3h` / `6h` / `24h` |
+| `--interval` | Required. `1m` / `5m` / `1h` / `6h` / `24h` (default `1h`) |
 | `--limit <n>` | Number of results (default 100, max 100) |
-| `--orderby <field>` | Sort field: `score` / `volume` / `swaps` / `liquidity` / `marketcap` / `holders` / `price` / `change` / `change1m` / `change5m` / `change1h` / `renowned_count` / `smart_degen_count` / `bluechip_owner_percentage` / `rank` / `creation_timestamp` / `square_mentions` / `history_highest_market_cap` / `gas_fee` |
+| `--order-by <field>` | Sort field: `default` / `swaps` / `marketcap` / `history_highest_market_cap` / `liquidity` / `volume` / `holder_count` / `smart_degen_count` / `renowned_count` / `gas_fee` / `price` / `change1m` / `change5m` / `change1h` / `creation_timestamp` |
 | `--direction <asc\|desc>` | Sort direction (default `desc`) |
-| `--filter <tag...>` | Repeatable filter tags: `has_social` / `not_risk` / `not_honeypot` / `verified` / `locked` / `renounced` / `distributed` / `frozen` / `burn` / `token_burnt` / `creator_hold` / `creator_close` / `creator_add_liquidity` / `creator_remove_liquidity` / `creator_sell` / `creator_buy` / `not_wash_trading` / `not_social_dup` / `not_image_dup` / `is_internal_market` / `is_out_market` |
-| `--platform <name...>` | Repeatable platform filter: `pump` / `moonshot` / `launchlab` |
+| `--filter <tag...>` | Repeatable filter tags (chain-specific). **sol** (defaults: `renounced frozen`): `renounced` / `frozen` / `burn` / `token_burnt` / `has_social` / `not_social_dup` / `not_image_dup` / `dexscr_update_link` / `not_wash_trading` / `is_internal_market` / `is_out_market`. **evm** (defaults: `not_honeypot verified renounced`): `not_honeypot` / `verified` / `renounced` / `locked` / `token_burnt` / `has_social` / `not_social_dup` / `not_image_dup` / `dexscr_update_link` / `is_internal_market` / `is_out_market` |
+| `--platform <name...>` | Repeatable platform filter (chain-specific). **sol**: `Pump.fun` / `pump_mayhem` / `pump_mayhem_agent` / `pump_agent` / `letsbonk` / `bonkers` / `bags` / `memoo` / `liquid` / `bankr` / `zora` / `surge` / `anoncoin` / `moonshot_app` / `wendotdev` / `heaven` / `sugar` / `token_mill` / `believe` / `trendsfun` / `trends_fun` / `jup_studio` / `Moonshot` / `boop` / `xstocks` / `ray_launchpad` / `meteora_virtual_curve` / `pool_ray` / `pool_meteora` / `pool_pump_amm` / `pool_orca`. **bsc**: `fourmeme` / `fourmeme_agent` / `bn_fourmeme` / `flap` / `clanker` / `lunafun` / `pool_uniswap` / `pool_pancake`. **base**: `clanker` / `bankr` / `flaunch` / `zora` / `zora_creator` / `baseapp` / `basememe` / `virtuals_v2` / `klik` |

 ## Usage Examples

+### Kline
+
 ```bash
 # Last 1 hour of 1-minute candles
 # macOS:
@@ -72,33 +106,221 @@ gmgn-cli market kline \
  --to $(date +%s)
 # Linux: use $(date -d '24 hours ago' +%s) instead of $(date -v-24H +%s)

-# Top 20 hot tokens on SOL in the last 1 hour, sorted by volume
-gmgn-cli market trending --chain sol --interval 1h --orderby volume --limit 20
-
-# Hot tokens with social links only, not risky, on BSC over 24h
-gmgn-cli market trending \
-  --chain bsc --interval 24h \
-  --filter has_social --filter not_risk
-
-# Pump platform tokens on SOL, last 6 hours
-gmgn-cli market trending --chain sol --interval 6h --platform pump
-
 # Raw output for further processing
 gmgn-cli market kline --chain sol --address <addr> \
  --resolution 5m --from <ts> --to <ts> --raw | jq '.[]'
 ```

+### Trending — General
+
+```bash
+# Top 20 hot tokens on SOL in the last 1 hour, sorted by volume
+gmgn-cli market trending --chain sol --interval 1h --order-by volume --limit 20
+
+# Top 50 tokens on SOL, 5m window, sorted by volume
+gmgn-cli market trending --chain sol --interval 5m --order-by volume --limit 50
+
+# Hot tokens with social links only, verified and not honeypot, on BSC over 24h
+gmgn-cli market trending \
+  --chain bsc --interval 24h \
+  --filter has_social --filter not_honeypot --filter verified
+```
+
+### Trending — SOL by Launchpad Platform
+
+Use `--platform` to filter trending results to tokens from specific launchpads only.
+
+```bash
+# SOL 1m hottest — Pump.fun + letsbonk only (most active launchpads), sorted by volume
+gmgn-cli market trending \
+  --chain sol --interval 1m \
+  --platform Pump.fun --platform letsbonk \
+  --order-by volume --limit 50 --raw
+
+# SOL 5m hottest — Pump.fun + letsbonk + Moonshot, sorted by volume
+gmgn-cli market trending \
+  --chain sol --interval 5m \
+  --platform Pump.fun --platform letsbonk --platform moonshot_app \
+  --order-by volume --limit 50 --raw
+
+# SOL 1h trending — Pump.fun only, with safety filters
+gmgn-cli market trending \
+  --chain sol --interval 1h \
+  --platform Pump.fun \
+  --filter renounced --filter frozen --filter not_wash_trading \
+  --order-by volume --limit 20 --raw
+
+# SOL 1h trending — all major launchpads combined
+gmgn-cli market trending \
+  --chain sol --interval 1h \
+  --platform Pump.fun --platform letsbonk --platform moonshot_app \
+  --platform pump_mayhem --platform pump_mayhem_agent --platform bonkers \
+  --order-by volume --limit 50 --raw
+```
+
+### Trending — BSC by Launchpad Platform
+
+```bash
+# BSC 1m hottest — fourmeme (main BSC launchpad), sorted by volume
+gmgn-cli market trending \
+  --chain bsc --interval 1m \
+  --platform fourmeme --platform four_xmode_agent \
+  --order-by volume --limit 50 --raw
+
+# BSC 5m hottest — fourmeme family, sorted by volume
+gmgn-cli market trending \
+  --chain bsc --interval 5m \
+  --platform fourmeme --platform fourmeme_agent --platform bn_fourmeme --platform four_xmode_agent \
+  --order-by volume --limit 50 --raw
+
+# BSC 1h trending — fourmeme with safety filters
+gmgn-cli market trending \
+  --chain bsc --interval 1h \
+  --platform fourmeme --platform fourmeme_agent --platform bn_fourmeme --platform four_xmode_agent \
+  --filter not_honeypot --filter verified \
+  --order-by volume --limit 20 --raw
+```
+
+### Trending — Base by Launchpad Platform
+
+```bash
+# Base 1m hottest — clanker + zora (main Base launchpads), sorted by volume
+gmgn-cli market trending \
+  --chain base --interval 1m \
+  --platform clanker --platform zora --platform zora_creator \
+  --order-by volume --limit 50 --raw
+
+# Base 5m hottest — clanker + zora + virtuals_v2 + flaunch, sorted by volume
+gmgn-cli market trending \
+  --chain base --interval 5m \
+  --platform clanker --platform zora --platform zora_creator \
+  --platform virtuals_v2 --platform flaunch \
+  --order-by volume --limit 50 --raw
+
+# Base 1h trending — all major launchpads with safety filters
+gmgn-cli market trending \
+  --chain base --interval 1h \
+  --platform clanker --platform zora --platform zora_creator \
+  --platform virtuals_v2 --platform flaunch --platform baseapp \
+  --filter not_honeypot --filter verified \
+  --order-by volume --limit 20 --raw
+```
+
+## `market trending` Response Fields
+
+The response is `data.rank` — an array of rank items. Each item represents one token.
+
+**Basic Info**
+
+| Field | Description |
+|-------|-------------|
+| `address` | Token contract address |
+| `symbol` / `name` | Token ticker and full name |
+| `logo` | Token logo image URL |
+| `chain` | Chain identifier |
+| `total_supply` | Total token supply |
+| `creator` | Creator wallet address |
+| `launchpad_platform` | Launch/pool platform (e.g. `Pump.fun`, `letsbonk`, `pool_meteora`, `fourmeme`) |
+| `exchange` | Current DEX (e.g. `meteora_damm_v2`, `raydium`, `pump_amm`) |
+| `open_timestamp` | Open market listing time (Unix seconds) |
+| `creation_timestamp` | Token creation time (Unix seconds) |
+| `rank` | Position in this trending list (lower = hotter) |
+| `hot_level` | Trending intensity level (higher = hotter) |
+
+**Price & Market**
+
+| Field | Description |
+|-------|-------------|
+| `price` | Current price in USD |
+| `market_cap` | Market cap in USD (directly available — no calculation needed) |
+| `liquidity` | Current liquidity in USD |
+| `volume` | Trading volume in USD for the queried interval |
+| `history_highest_market_cap` | All-time highest market cap in USD |
+| `initial_liquidity` | Initial liquidity at token launch |
+| `price_change_percent` | Price change % for the queried interval |
+| `price_change_percent1m` | Price change % in last 1 minute |
+| `price_change_percent5m` | Price change % in last 5 minutes |
+| `price_change_percent1h` | Price change % in last 1 hour |
+
+**Trading Activity**
+
+| Field | Description |
+|-------|-------------|
+| `swaps` | Total swap count in the queried interval |
+| `buys` / `sells` | Buy / sell count in the interval |
+| `holder_count` | Number of unique token holders |
+| `gas_fee` | Average gas fee per transaction |
+
+**Security & Risk**
+
+| Field | Chains | Description |
+|-------|--------|-------------|
+| `renounced_mint` | SOL | Mint authority renounced (`1` = yes, `0` = no) |
+| `renounced_freeze_account` | SOL | Freeze authority renounced (`1` = yes, `0` = no) |
+| `is_honeypot` | BSC / Base | Honeypot flag (`1` = yes, `0` = no) |
+| `is_open_source` | all | Contract verified (`1` = yes, `0` = no) |
+| `is_renounced` | all | Ownership renounced (`1` = yes, `0` = no) |
+| `buy_tax` / `sell_tax` | all | Tax rate — empty string means `0` (no tax) |
+| `burn_status` | all | Liquidity burn status (e.g. `"none"`, `"burn"`) |
+| `top_10_holder_rate` | all | Top 10 wallets concentration (0–1) |
+| `rug_ratio` | all | Rug pull risk score (0–1) |
+| `is_wash_trading` | all | Wash trading detected (`true` / `false`) |
+| `rat_trader_amount_rate` | all | Ratio of insider/sneak trading volume |
+| `bundler_rate` | all | Ratio of bundle bot trading volume |
+| `entrapment_ratio` | all | Entrapment trading ratio |
+| `sniper_count` | all | Number of sniper wallets at launch |
+| `bot_degen_count` / `bot_degen_rate` | all | Bot degen wallet count / ratio |
+| `dev_team_hold_rate` | all | Dev team holding ratio |
+| `top70_sniper_hold_rate` | all | Top 70 sniper current holding ratio |
+| `lock_percent` | all | Liquidity lock percentage |
+
+**Dev Status**
+
+| Field | Description |
+|-------|-------------|
+| `creator_token_status` | Dev holding status: `creator_hold` (still holding) / `creator_close` (sold/closed) |
+| `creator_close` | Boolean shorthand for `creator_token_status == creator_close` |
+| `dev_token_burn_ratio` | Ratio of dev's tokens that have been burned |
+
+**Smart Money**
+
+| Field | Description |
+|-------|-------------|
+| `smart_degen_count` | Number of smart money wallets holding the token |
+| `renowned_count` | Number of renowned / KOL wallets holding the token |
+| `bluechip_owner_percentage` | Ratio of holders that are bluechip wallets (0–1) |
+
+**Social**
+
+| Field | Description |
+|-------|-------------|
+| `twitter_username` | Twitter / X username (not a full URL — prepend `https://x.com/` to get the link) |
+| `website` | Project website URL |
+| `telegram` | Telegram URL |
+| `cto_flag` | Community takeover flag (`1` = CTO has occurred) |
+
+**Dexscreener Marketing**
+
+| Field | Description |
+|-------|-------------|
+| `dexscr_ad` | Dexscreener ad placed (`1` = yes) |
+| `dexscr_update_link` | Social links updated on Dexscreener (`1` = yes) |
+| `dexscr_trending_bar` | Paid for Dexscreener trending bar (`1` = yes) |
+| `dexscr_boost_fee` | Dexscreener boost amount paid (0 = none) |
+
+---
+
 ## Workflow: Discover Trading Opportunities via Trending

 ### Step 1 — Fetch trending data

-Fetch a broad pool with safe filters, sorted by GMGN's composite score:
+Fetch a broad pool with safe filters:

 ```bash
 gmgn-cli market trending \
  --chain <chain> --interval 1h \
-  --orderby score --limit 50 \
-  --filter not_risk --filter not_honeypot --filter has_social --raw
+  --order-by volume --limit 50 \
+  --filter not_honeypot --filter has_social --raw
 ```

 ### Step 2 — AI multi-factor analysis
@@ -107,7 +329,6 @@ Analyze each record in the response using the following signals (apply judgment,

 | Signal | Field(s) | Weight | Notes |
 |--------|----------|--------|-------|
-| GMGN quality score | `score` | High | Primary ranking signal from GMGN |
 | Smart money interest | `smart_degen_count`, `renowned_count` | High | Key conviction indicator |
 | Bluechip ownership | `bluechip_owner_percentage` | Medium | Quality of holder base |
 | Real trading activity | `volume`, `swaps` | Medium | Distinguishes genuine interest from wash trading |
@@ -115,7 +336,7 @@ Analyze each record in the response using the following signals (apply judgment,
 | Pool safety | `liquidity` | Medium | Low liquidity = high slippage risk |
 | Token maturity | `creation_timestamp` | Low | Avoid tokens less than ~1h old unless other signals are very strong |

-Select the **top 5** tokens with the best composite profile. Prefer tokens that score well across multiple signals rather than excelling in just one.
+Select the **top 5** tokens with the best composite profile. Prefer tokens that perform well across multiple signals rather than excelling in just one.

 ### Step 3 — Present top 5 to user

@@ -124,8 +345,8 @@ Present results as a concise table, then give a one-line rationale for each pick
 ```
 Top 5 Trending Tokens — SOL / 1h

-# | Symbol | Address (short) | Score | Smart Degens | Volume | 1h Chg | Reasoning
-1 | ...     | ...             | ...   | ...          | ...    | ...    | High score + smart money accumulating
+# | Symbol | Address (short) | Smart Degens | Volume | 1h Chg | Reasoning
+1 | ...     | ...             | ...          | ...    | ...    | Smart money accumulating + high volume
 2 | ...
 ...
 ```
@@ -136,6 +357,194 @@ For each token, offer:
 - **Deep dive**: `token info` + `token security` for full due diligence
 - **Swap**: execute directly if the user is satisfied with the trending data alone

+## `market trenches` Parameters
+
+**Intent → `--type` mapping (always specify `--type` explicitly):**
+
+| User intent | `--type` value |
+|-------------|----------------|
+| "new tokens", "just launched", "newly created", "latest tokens" | `new_creation` |
+| "about to graduate", "near completion", "bonding curve almost full" | `near_completion` |
+| "graduated tokens", "already on DEX", "open market tokens" | `completed` |
+| No specific stage mentioned | omit `--type` (returns all three) |
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--chain` | Yes | `sol` / `bsc` / `base` |
+| `--type` | No | Categories to query, repeatable: `new_creation` / `near_completion` / `completed` (default: all three) |
+| `--launchpad-platform` | No | Launchpad platform filter, repeatable (default: all platforms for the chain) |
+| `--limit` | No | Max results per category, max 80 (default: 80) |
+
+Response fields: `data.new_creation`, `data.pump`, `data.completed` — each is an array of `RankItem` (same fields as `market trending` rank items). **Important: `data.pump` in the response corresponds to `--type near_completion` in the request. The API always returns this category under the key `pump`, not `near_completion`.**
+
+## `market trenches` Response Fields
+
+**Basic Info**
+
+| Field | Description |
+|-------|-------------|
+| `address` | Token contract address |
+| `symbol` / `name` | Token symbol and name |
+| `launchpad_platform` | Launch platform (e.g. `Pump.fun`, `letsbonk`) |
+| `exchange` | Current exchange (e.g. `pump_amm`, `raydium`) |
+| `usd_market_cap` | Market cap in USD |
+| `liquidity` | Liquidity in USD |
+| `total_supply` | Total token supply |
+| `created_timestamp` | Creation time (Unix seconds) |
+| `open_timestamp` | Open market listing time (Unix seconds, `completed` only) |
+| `complete_timestamp` | Bonding curve completion time (Unix seconds) |
+| `complete_cost_time` | Time from creation to completion in seconds |
+
+**Trading Data**
+
+| Field | Description |
+|-------|-------------|
+| `swaps_1m` / `swaps_1h` / `swaps_24h` | Swap count per time window |
+| `volume_1h` / `volume_24h` | Trading volume in USD |
+| `buys_24h` / `sells_24h` | Buy / sell count in 24h |
+| `net_buy_24h` | Net buy volume in 24h |
+| `holder_count` | Number of token holders |
+
+**Security & Risk**
+
+| Field | Chains | Description |
+|-------|--------|-------------|
+| `renounced_mint` | SOL | Whether mint authority is renounced (SOL-specific concept; always `false` on EVM chains) |
+| `renounced_freeze_account` | SOL | Whether freeze authority is renounced (SOL-specific concept; always `false` on EVM chains) |
+| `burn_status` | all | Liquidity burn status |
+| `rug_ratio` | all | Rug pull risk ratio |
+| `top_10_holder_rate` | all | Top 10 holders concentration ratio |
+| `rat_trader_amount_rate` | all | Insider / sneak trading volume ratio |
+| `bundler_trader_amount_rate` | all | Bundle trading volume ratio |
+| `is_wash_trading` | all | Whether wash trading is detected |
+| `sniper_count` | all | Number of sniper wallets |
+| `suspected_insider_hold_rate` | all | Suspected insider holding ratio |
+| `open_source` | all | Whether contract source code is verified (`"yes"` / `"no"` / `"unknown"`) |
+| `owner_renounced` | all | Whether contract ownership is renounced (`"yes"` / `"no"` / `"unknown"`) |
+| `is_honeypot` | BSC / Base | Whether token is a honeypot (`"yes"` / `"no"`); returns empty string on SOL (not applicable) |
+| `buy_tax` | all | Buy tax ratio (e.g. `0.03` = 3%) |
+| `dev_team_hold_rate` | all | Dev team holding ratio |
+
+**Dev Holdings**
+
+| Field | Description |
+|-------|-------------|
+| `creator_token_status` | Dev holding status (e.g. `creator_hold`, `creator_close`) |
+| `creator_balance_rate` | Dev holding ratio as a proportion of total supply |
+
+**Smart Money**
+
+| Field | Description |
+|-------|-------------|
+| `smart_degen_count` | Number of smart money holders |
+| `renowned_count` | Number of renowned wallet holders (KOL) |
+
+**Social Media**
+
+| Field | Description |
+|-------|-------------|
+| `twitter` | Twitter / X link |
+| `telegram` | Telegram link |
+| `website` | Website link |
+| `instagram` | Instagram link |
+| `tiktok` | TikTok link |
+| `has_at_least_one_social` | Whether any social media link exists |
+| `x_user_follower` | Twitter follower count |
+| `cto_flag` | Whether community takeover (CTO) has occurred |
+
+**Dexscreener Marketing**
+
+| Field | Description |
+|-------|-------------|
+| `dexscr_ad` | Whether a Dexscreener ad has been placed |
+| `dexscr_update_link` | Whether social links have been updated on Dexscreener |
+| `dexscr_trending_bar` | Whether paid for Dexscreener trending bar placement |
+| `dexscr_boost_fee` | Amount paid for Dexscreener boost (0 = none) |
+
+### Solana Trenches Examples
+
+```bash
+# All three categories at once
+gmgn-cli market trenches --chain sol --raw \
+  --type new_creation --type near_completion --type completed \
+  --launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform pump_mayhem_agent --launchpad-platform pump_agent --launchpad-platform letsbonk --launchpad-platform bonkers --launchpad-platform bags \
+  --limit 80
+
+# New creation only
+gmgn-cli market trenches --chain sol --raw \
+  --type new_creation \
+  --launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform pump_mayhem_agent --launchpad-platform pump_agent --launchpad-platform letsbonk --launchpad-platform bonkers --launchpad-platform bags \
+  --limit 80
+
+# Near completion only
+gmgn-cli market trenches --chain sol --raw \
+  --type near_completion \
+  --launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform pump_mayhem_agent --launchpad-platform pump_agent --launchpad-platform letsbonk --launchpad-platform bonkers --launchpad-platform bags \
+  --limit 80
+
+# Completed (open market) only
+gmgn-cli market trenches --chain sol --raw \
+  --type completed \
+  --launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform pump_mayhem_agent --launchpad-platform pump_agent --launchpad-platform letsbonk --launchpad-platform bonkers --launchpad-platform bags \
+  --limit 80
+```
+
+### BSC Trenches Examples
+
+```bash
+# All three categories at once
+gmgn-cli market trenches --chain bsc --raw \
+  --type new_creation --type near_completion --type completed \
+  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent --launchpad-platform flap --launchpad-platform clanker --launchpad-platform lunafun \
+  --limit 80
+
+# New creation only
+gmgn-cli market trenches --chain bsc --raw \
+  --type new_creation \
+  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent --launchpad-platform flap --launchpad-platform clanker --launchpad-platform lunafun \
+  --limit 80
+
+# Near completion only
+gmgn-cli market trenches --chain bsc --raw \
+  --type near_completion \
+  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent --launchpad-platform flap --launchpad-platform clanker --launchpad-platform lunafun \
+  --limit 80
+
+# Completed (open market) only
+gmgn-cli market trenches --chain bsc --raw \
+  --type completed \
+  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent --launchpad-platform flap --launchpad-platform clanker --launchpad-platform lunafun \
+  --limit 80
+```
+
+### Base Trenches Examples
+
+```bash
+# All three categories at once
+gmgn-cli market trenches --chain base --raw \
+  --type new_creation --type near_completion --type completed \
+  --launchpad-platform clanker --launchpad-platform bankr --launchpad-platform flaunch --launchpad-platform zora --launchpad-platform zora_creator --launchpad-platform baseapp --launchpad-platform basememe --launchpad-platform virtuals_v2 --launchpad-platform klik \
+  --limit 80
+
+# New creation only
+gmgn-cli market trenches --chain base --raw \
+  --type new_creation \
+  --launchpad-platform clanker --launchpad-platform bankr --launchpad-platform flaunch --launchpad-platform zora --launchpad-platform zora_creator --launchpad-platform baseapp --launchpad-platform basememe --launchpad-platform virtuals_v2 --launchpad-platform klik \
+  --limit 80
+
+# Near completion only
+gmgn-cli market trenches --chain base --raw \
+  --type near_completion \
+  --launchpad-platform clanker --launchpad-platform bankr --launchpad-platform flaunch --launchpad-platform zora --launchpad-platform zora_creator --launchpad-platform baseapp --launchpad-platform basememe --launchpad-platform virtuals_v2 --launchpad-platform klik \
+  --limit 80
+
+# Completed (open market) only
+gmgn-cli market trenches --chain base --raw \
+  --type completed \
+  --launchpad-platform clanker --launchpad-platform bankr --launchpad-platform flaunch --launchpad-platform zora --launchpad-platform zora_creator --launchpad-platform baseapp --launchpad-platform basememe --launchpad-platform virtuals_v2 --launchpad-platform klik \
+  --limit 80
+```
+
 ## Notes

 - `market kline`: `--from` and `--to` are Unix timestamps in **seconds** — CLI converts to milliseconds automatically
@@ -4,6 +4,8 @@ description: Query GMGN wallet portfolio — API Key wallet info, holdings, tran
 argument-hint: "<info|holdings|activity|stats|token-balance> [--chain <sol|bsc|base>] [--wallet <wallet_address>]"
 ---

+**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.**
+
 Use the `gmgn-cli` tool to query wallet portfolio data based on the user's request.

 ## Sub-commands
@@ -24,7 +26,7 @@ Use the `gmgn-cli` tool to query wallet portfolio data based on the user's reque

 - `.env` file with `GMGN_API_KEY` set
 - Run from the directory where your `.env` file is located, or set `GMGN_HOST` in your environment
- `gmgn-cli` installed globally: `npm install -g gmgn-cli@1.0.1`
+- `gmgn-cli` installed globally: `npm install -g gmgn-cli`

 ## Usage Examples

@@ -69,13 +71,13 @@ gmgn-cli portfolio token-balance \
  --chain sol --wallet <wallet_address> --token <token_address>
 ```

-## Holdings Options
+## `portfolio holdings` Options

 | Option | Description |
 |--------|-------------|
 | `--limit <n>` | Page size (default `20`, max 50) |
 | `--cursor <cursor>` | Pagination cursor |
-| `--order-by <field>` | Sort field: `usd_value` / `price` / `unrealized_profit` / `realized_profit` / `total_profit` / `history_bought_cost` / `history_sold_income` (default `usd_value`) |
+| `--order-by <field>` | Sort field: `usd_value` / `last_active_timestamp` / `realized_profit` / `unrealized_profit` / `total_profit` / `history_bought_cost` / `history_sold_income` (default `usd_value`) |
 | `--direction <asc\|desc>` | Sort direction (default `desc`) |
 | `--sell-out` | Include sold-out positions |
 | `--show-small` | Include small-value positions |
@@ -84,16 +86,18 @@ gmgn-cli portfolio token-balance \
 | `--hide-closed` | Hide closed positions |
 | `--hide-open` | Hide open positions |

-## Activity Options
+## `portfolio activity` Options

 | Option | Description |
 |--------|-------------|
 | `--token <address>` | Filter by token |
 | `--limit <n>` | Page size |
-| `--cursor <cursor>` | Pagination cursor |
+| `--cursor <cursor>` | Pagination cursor (pass the `next` value from the previous response) |
 | `--type <type>` | Repeatable: `buy` / `sell` / `add` / `remove` / `transfer` |

-## Stats Options
+The activity response includes a `next` field. Pass it to `--cursor` to fetch the next page.
+
+## `portfolio stats` Options

 | Option | Description |
 |--------|-------------|
@@ -105,3 +109,4 @@ gmgn-cli portfolio token-balance \
 - `portfolio stats` supports multiple `--wallet` flags for batch queries
 - Use `--raw` to get single-line JSON for further processing
 - **Input validation** — Wallet and token addresses are validated against the expected chain format at runtime (sol: base58 32–44 chars; bsc/base/eth: `0x` + 40 hex digits). The CLI exits with an error on invalid input.
+- For follow-wallet, KOL, and Smart Money trade records, use the `gmgn-track` skill (`track follow-wallet` / `track kol` / `track smartmoney`)
@@ -4,6 +4,8 @@ description: "[FINANCIAL EXECUTION] Submit a real blockchain token swap or query
 argument-hint: "[--chain <chain> --from <wallet> --input-token <addr> --output-token <addr> --amount <n>] | [order get --chain <chain> --order-id <id>]"
 ---

+**IMPORTANT: Always use `gmgn-cli` commands below. Do NOT use web search, WebFetch, curl, or visit gmgn.ai — all swap operations must go through the CLI. The CLI handles signing and submission automatically.**
+
 Use the `gmgn-cli` tool to submit a token swap or query an existing order. **Requires private key** (`GMGN_PRIVATE_KEY` in `.env`).

 ## Financial Risk Notice
@@ -20,6 +22,7 @@ Use the `gmgn-cli` tool to submit a token swap or query an existing order. **Req
 | Sub-command | Description |
 |-------------|-------------|
 | `swap` | Submit a token swap |
+| `order quote` | Get a swap quote (no transaction submitted) |
 | `order get` | Query order status |

 ## Supported Chains
@@ -45,7 +48,7 @@ Both `GMGN_API_KEY` and `GMGN_PRIVATE_KEY` must be set in `.env`. The private ke
 `gmgn-cli` must be installed globally before use (one-time setup):

 ```bash
-npm install -g gmgn-cli@1.0.1
+npm install -g gmgn-cli
 ```

 ### Credential Model
@@ -54,7 +57,7 @@ npm install -g gmgn-cli@1.0.1
 - `GMGN_PRIVATE_KEY` is used exclusively for **local message signing** — the private key never leaves the machine. The CLI computes an Ed25519 or RSA-SHA256 signature in-process and transmits only the base64-encoded result in the `X-Signature` request header.
 - `GMGN_API_KEY` is transmitted in the `X-APIKEY` request header to GMGN's servers over HTTPS.

-## Swap Usage
+## `swap` Usage

 ```bash
 # Basic swap
@@ -74,6 +77,15 @@ gmgn-cli swap \
  --amount 1000000 \
  --slippage 0.01

+# With automatic slippage
+gmgn-cli swap \
+  --chain sol \
+  --from <wallet_address> \
+  --input-token <input_token_address> \
+  --output-token <output_token_address> \
+  --amount 1000000 \
+  --auto-slippage
+
 # With anti-MEV (SOL)
 gmgn-cli swap \
  --chain sol \
@@ -92,13 +104,38 @@ gmgn-cli swap \
  --percent 50
 ```

-## Order Query
+## `order quote` Usage
+
+Get an estimated output amount before submitting a swap. Uses normal auth — no private key required.
+
+```bash
+gmgn-cli order quote \
+  --chain sol \
+  --from <wallet_address> \
+  --input-token <input_token_address> \
+  --output-token <output_token_address> \
+  --amount <input_amount_smallest_unit> \
+  --slippage 0.01
+```
+
+### `order quote` Response Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `input_token` | string | Input token contract address |
+| `output_token` | string | Output token contract address |
+| `input_amount` | string | Input amount (smallest unit) |
+| `output_amount` | string | Expected output amount (smallest unit) |
+| `min_output_amount` | string | Minimum output after slippage |
+| `slippage` | number | Actual slippage percentage |
+
+## `order get` Usage

 ```bash
 gmgn-cli order get --chain sol --order-id <order_id>
 ```

-## Swap Parameters
+## `swap` Parameters

 | Parameter | Required | Description |
 |-----------|----------|-------------|
@@ -109,6 +146,7 @@ gmgn-cli order get --chain sol --order-id <order_id>
 | `--amount` | No* | Input amount in smallest unit. Required unless `--percent` is used. |
 | `--percent <pct>` | No* | Sell percentage of `input_token`, e.g. `50` = 50%, `1` = 1%. Sets `input_amount` to `0` automatically. **Only valid when `input_token` is NOT a currency (SOL/BNB/ETH/USDC).** |
 | `--slippage <n>` | No | Slippage tolerance, e.g. `0.01` = 1% |
+| `--auto-slippage` | No | Enable automatic slippage |
 | `--min-output <n>` | No | Minimum output amount |
 | `--anti-mev` | No | Enable anti-MEV protection (default true) |
 | `--priority-fee <sol>` | No | Priority fee in SOL (≥ 0.00001, SOL only) |
@@ -118,19 +156,15 @@ gmgn-cli order get --chain sol --order-id <order_id>
 | `--max-fee-per-gas <n>` | No | EIP-1559 max fee per gas (Base only) |
 | `--max-priority-fee-per-gas <n>` | No | EIP-1559 max priority fee per gas (Base only) |

-## Swap Response Fields
+## `swap` Response Fields

 | Field | Type | Description |
 |-------|------|-------------|
 | `order_id` | string | Order ID for follow-up queries |
 | `hash` | string | Transaction hash |
-| `state` | int | Order state code |
-| `confirmation.state` | string | `processed` / `confirmed` / `failed` / `expired` |
-| `confirmation.detail` | string | Confirmation detail message |
+| `status` | string | Order status: `pending` / `processed` / `confirmed` / `failed` / `expired` |
 | `error_code` | string | Error code on failure |
 | `error_status` | string | Error description on failure |
-| `height` | number | Block height of the transaction |
-| `order_height` | number | Block height when the order was placed |
 | `input_token` | string | Input token contract address |
 | `output_token` | string | Output token contract address |
 | `filled_input_amount` | string | Actual input consumed (smallest unit); empty if not filled |
@@ -160,6 +194,20 @@ Before passing any address or amount to a command:

 4. **User confirmation** — See "Execution Guidelines" below — always present resolved parameters to the user before executing a swap. This creates a human review checkpoint for any unexpected values.

+## Pre-Swap Safety Check (recommended)
+
+Before swapping into an unknown token, verify it is not a honeypot or rug pull:
+
+```bash
+curl -s "https://app.maiat.io/api/v1/token/<output_token_address>" | jq '{trustScore: .trustScore, verdict: .verdict, riskFlags: .riskFlags}'
+```
+
+- If `verdict` is `"avoid"` → **do NOT proceed** with the swap.
+- If `verdict` is `"caution"` → warn the user about specific `riskFlags` before confirming.
+- If `verdict` is `"proceed"` or `"trusted"` → safe to continue.
+
+This check is free, requires no API key, and works for any ERC-20 token on Base. Powered by [Maiat](https://app.maiat.io) — trust infrastructure for on-chain agents.
+
 ## Execution Guidelines

 - **Currency resolution** — When the user names a currency (SOL/BNB/ETH/USDC) instead of providing an address, look up its address in the Chain Currencies table and apply it automatically — never ask the user for it.
@@ -169,7 +217,7 @@ Before passing any address or amount to a command:
 - **Percentage sell restriction** — `--percent` is ONLY valid when `input_token` is NOT a currency. Do NOT use `--percent` when `input_token` is SOL/BNB/ETH (native) or USDC. This includes: "sell 50% of my SOL", "use 30% of my BNB to buy X", "spend 50% of my USDC on X" — all unsupported. Explain the restriction to the user and ask for an explicit absolute amount instead.
 - **Chain-wallet compatibility** — SOL addresses are incompatible with EVM chains (bsc/base). Warn the user and abort if the address format does not match the chain.
 - **Credential sensitivity** — `GMGN_API_KEY` and `GMGN_PRIVATE_KEY` can directly execute trades on the linked wallet. Never log, display, or expose these values.
- **Order polling** — After a swap, if `confirmation.state` is not yet `confirmed` / `failed` / `expired`, poll with `order get` up to 3 times at 5-second intervals before reporting a timeout. Once confirmed, display the trade result using `filled_input_amount` and `filled_output_amount` (convert from smallest unit using token decimals), e.g. "Spent 0.1 SOL → received 98.5 USDC" or "Sold 1000 TOKEN → received 0.08 SOL".
+- **Order polling** — After a swap, if `status` is not yet `confirmed` / `failed` / `expired`, poll with `order get` up to 3 times at 5-second intervals before reporting a timeout. Once confirmed, display the trade result using `filled_input_amount` and `filled_output_amount` (convert from smallest unit using token decimals), e.g. "Spent 0.1 SOL → received 98.5 USDC" or "Sold 1000 TOKEN → received 0.08 SOL".
 - **Block explorer links** — After a successful swap, display a clickable explorer link for the returned `hash`:

  | Chain | Explorer |
@@ -1,20 +1,22 @@
 ---
 name: gmgn-token
 description: Query GMGN token information — basic info, security, pool, top holders and top traders. Supports sol / bsc / base.
-argument-hint: <sub-command> --chain <sol|bsc|base> --address <token_address>
+argument-hint: "<sub-command> --chain <sol|bsc|base> --address <token_address>"
 ---

+**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.**
+
 Use the `gmgn-cli` tool to query token information based on the user's request.

 ## Sub-commands

 | Sub-command | Description |
 |-------------|-------------|
-| `token info` | Basic info + realtime price |
-| `token security` | Security metrics (holder concentration, contract risks) |
-| `token pool` | Liquidity pool info |
-| `token holders` | Top token holders list |
-| `token traders` | Top token traders list |
+| `token info` | Basic info + realtime price, liquidity, supply, holder count, social links (market cap = price × circulating_supply) |
+| `token security` | Security metrics (honeypot, taxes, holder concentration, contract risks) |
+| `token pool` | Liquidity pool info (DEX, reserves, liquidity depth) |
+| `token holders` | Top token holders list with profit/loss breakdown |
+| `token traders` | Top token traders list with profit/loss breakdown |

 ## Supported Chains

@@ -24,34 +26,390 @@ Use the `gmgn-cli` tool to query token information based on the user's request.

 - `.env` file with `GMGN_API_KEY` set
 - Run from the directory where your `.env` file is located, or set `GMGN_HOST` in your environment
- `gmgn-cli` installed globally: `npm install -g gmgn-cli@1.0.1`
+- `gmgn-cli` installed globally: `npm install -g gmgn-cli`
+
+## Parameters — `token info` / `token security` / `token pool`
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--chain` | Yes | `sol` / `bsc` / `base` |
+| `--address` | Yes | Token contract address |
+| `--raw` | No | Output raw single-line JSON (for piping or further processing) |
+
+## Parameters — `token holders` / `token traders`
+
+| Parameter | Required | Default | Description |
+|-----------|----------|---------|-------------|
+| `--chain` | Yes | — | `sol` / `bsc` / `base` |
+| `--address` | Yes | — | Token contract address |
+| `--limit` | No | `20` | Number of results, max `100` |
+| `--order-by` | No | `amount_percentage` | Sort field — see table below |
+| `--direction` | No | `desc` | Sort direction: `asc` / `desc` |
+| `--tag` | No | `renowned` | Wallet filter: `renowned` (KOL wallets) / `smart_degen` (smart money) |
+| `--raw` | No | — | Output raw single-line JSON |
+
+### `--order-by` Values
+
+| Value | Description |
+|-------|-------------|
+| `amount_percentage` | Sort by percentage of total supply held (default) |
+| `profit` | Sort by realized profit in USD |
+| `unrealized_profit` | Sort by unrealized profit in USD |
+| `buy_volume_cur` | Sort by buy volume |
+| `sell_volume_cur` | Sort by sell volume |
+
+### `--tag` Values
+
+| Value | Description |
+|-------|-------------|
+| `renowned` | KOL / well-known wallets (influencers, funds, public figures) |
+| `smart_degen` | Smart money wallets (historically high-performing traders) |
+
+## Response Field Reference
+
+### `token info` — Key Fields
+
+The response has four nested objects: `pool`, `link`, `stat`, `wallet_tags_stat`. Access fields with dot notation when parsing (e.g. `link.website`, `stat.top_10_holder_rate`).
+
+**Top-level Fields**
+
+| Field | Description |
+|-------|-------------|
+| `address` | Token contract address |
+| `symbol` / `name` | Token ticker and full name |
+| `decimals` | Token decimal places |
+| `total_supply` | Total token supply (same as `circulating_supply` for most tokens) |
+| `circulating_supply` | Circulating supply |
+| `max_supply` | Maximum supply |
+| `price` | Current price in USD |
+| `liquidity` | Total liquidity in USD (from biggest pool) |
+| `holder_count` | Number of unique token holders |
+| `logo` | Token logo image URL |
+| `creation_timestamp` | Token creation time (Unix seconds) |
+| `open_timestamp` | Time the token opened for trading (Unix seconds) |
+| `biggest_pool_address` | Address of the main liquidity pool |
+| `og` | Whether the token is flagged as an OG token (`true` / `false`) |
+
+**`pool` Object** — Main liquidity pool details
+
+| Field | Description |
+|-------|-------------|
+| `pool.pool_address` | Pool contract address |
+| `pool.quote_address` | Quote token address (e.g. USDC, SOL, WETH) |
+| `pool.quote_symbol` | Quote token symbol (e.g. `USDC`, `SOL`) |
+| `pool.exchange` | DEX name (e.g. `meteora_dlmm`, `raydium`, `pump_amm`, `uniswap_v3`) |
+| `pool.liquidity` | Pool liquidity in USD |
+| `pool.base_reserve` | Base token reserve amount |
+| `pool.quote_reserve` | Quote token reserve amount |
+| `pool.base_reserve_value` | Base reserve USD value |
+| `pool.quote_reserve_value` | Quote reserve USD value |
+| `pool.fee_ratio` | Pool trading fee ratio (e.g. `0.1` = 0.1%) |
+| `pool.creation_timestamp` | Pool creation time (Unix seconds) |
+
+**`link` Object** — Social and explorer links
+
+| Field | Description |
+|-------|-------------|
+| `link.twitter_username` | Twitter / X username (not full URL) |
+| `link.website` | Project website URL |
+| `link.telegram` | Telegram URL |
+| `link.discord` | Discord URL |
+| `link.instagram` | Instagram URL |
+| `link.tiktok` | TikTok URL |
+| `link.youtube` | YouTube URL |
+| `link.description` | Token description text |
+| `link.gmgn` | GMGN token page URL |
+| `link.geckoterminal` | GeckoTerminal page URL |
+| `link.verify_status` | Social verification status (integer) |
+
+**`stat` Object** — On-chain statistics
+
+| Field | Description |
+|-------|-------------|
+| `stat.holder_count` | Number of holders (same as top-level `holder_count`) |
+| `stat.bluechip_owner_count` | Number of bluechip wallet holders |
+| `stat.bluechip_owner_percentage` | Ratio of holders that are bluechip wallets (0–1) |
+| `stat.top_10_holder_rate` | Ratio of supply held by top 10 wallets (0–1) |
+| `stat.dev_team_hold_rate` | Ratio held by dev team wallets |
+| `stat.creator_hold_rate` | Ratio held by creator wallet |
+| `stat.creator_token_balance` | Raw creator token balance |
+| `stat.top_rat_trader_percentage` | Ratio of volume from rat/insider traders |
+| `stat.top_bundler_trader_percentage` | Ratio of volume from bundler bots |
+| `stat.top_entrapment_trader_percentage` | Ratio of volume from entrapment traders |
+| `stat.bot_degen_count` | Number of bot degen wallets |
+| `stat.bot_degen_rate` | Ratio of bot degen wallets |
+| `stat.fresh_wallet_rate` | Ratio of fresh/new wallets among holders |
+
+**`wallet_tags_stat` Object** — Wallet type breakdown
+
+| Field | Description |
+|-------|-------------|
+| `wallet_tags_stat.smart_wallets` | Number of smart money wallets holding the token |
+| `wallet_tags_stat.renowned_wallets` | Number of renowned / KOL wallets holding the token |
+| `wallet_tags_stat.sniper_wallets` | Number of sniper wallets |
+| `wallet_tags_stat.rat_trader_wallets` | Number of rat trader wallets |
+| `wallet_tags_stat.bundler_wallets` | Number of bundler bot wallets |
+| `wallet_tags_stat.whale_wallets` | Number of whale wallets |
+| `wallet_tags_stat.fresh_wallets` | Number of fresh wallets |
+| `wallet_tags_stat.top_wallets` | Number of top-ranked wallets |
+
+---
+
+### `token security` — Key Fields
+
+**Contract Safety**
+
+| Field | Chains | Description |
+|-------|--------|-------------|
+| `is_honeypot` | BSC / Base | Whether token is a honeypot (`"yes"` / `"no"`); empty string on SOL |
+| `open_source` | all | Contract source code verified: `"yes"` / `"no"` / `"unknown"` |
+| `owner_renounced` | all | Contract ownership renounced: `"yes"` / `"no"` / `"unknown"` |
+| `renounced_mint` | SOL | Mint authority renounced (SOL-specific; always `false` on EVM) |
+| `renounced_freeze_account` | SOL | Freeze authority renounced (SOL-specific; always `false` on EVM) |
+| `buy_tax` / `sell_tax` | all | Tax ratio — e.g. `0.03` = 3%; `0` = no tax |
+
+**Holder Concentration & Risk**
+
+| Field | Description |
+|-------|-------------|
+| `top_10_holder_rate` | Ratio of supply held by top 10 wallets (0–1); higher = more concentrated |
+| `dev_team_hold_rate` | Ratio held by dev team wallets |
+| `creator_balance_rate` | Ratio held by the token creator wallet |
+| `creator_token_status` | Dev holding status: `creator_hold` (still holding) / `creator_close` (sold/closed) |
+| `suspected_insider_hold_rate` | Ratio held by suspected insider wallets |
+
+**Trading Risk**
+
+| Field | Description |
+|-------|-------------|
+| `rug_ratio` | Rug pull risk score (0–1); higher = more risky |
+| `is_wash_trading` | Whether wash trading activity is detected (`true` / `false`) |
+| `rat_trader_amount_rate` | Ratio of volume from sneak/insider trading |
+| `bundler_trader_amount_rate` | Ratio of volume from bundle trading (bot-driven) |
+| `sniper_count` | Number of sniper wallets that bought at launch |
+| `burn_status` | Liquidity pool burn status (e.g. `"burn"` = burned, `""` = not burned) |
+
+---
+
+### `token pool` — Key Fields
+
+| Field | Description |
+|-------|-------------|
+| `address` | Pool contract address |
+| `base_address` | Base token address (the queried token) |
+| `quote_address` | Quote token address (e.g. SOL, USDC, WETH) |
+| `exchange` | DEX name (e.g. `raydium`, `pump_amm`, `uniswap_v3`, `pancakeswap`) |
+| `liquidity` | Pool liquidity in USD |
+| `base_reserve` | Base token reserve amount |
+| `quote_reserve` | Quote token reserve amount |
+| `price` | Current price in USD derived from pool reserves |
+| `creation_timestamp` | Pool creation time (Unix seconds) |
+
+---
+
+### `token holders` / `token traders` — Item Fields
+
+Each item in the result array:
+
+| Field | Description |
+|-------|-------------|
+| `address` | Wallet address |
+| `name` | Wallet label or alias (if known) |
+| `tags` | Wallet tags (e.g. `["renowned"]`, `["smart_degen"]`) |
+| `amount_percentage` | Percentage of total supply held (0–1); e.g. `0.05` = 5% |
+| `amount` | Raw token amount held |
+| `value` | USD value of holdings |
+| `profit` | Realized profit in USD (positive = profit, negative = loss) |
+| `unrealized_profit` | Unrealized profit in USD based on current price |
+| `buy_volume_cur` | Total buy volume in USD for the current period |
+| `sell_volume_cur` | Total sell volume in USD for the current period |
+| `profit_change` | Profit change ratio |
+
+---

 ## Usage Examples

+### `token info` — Fetch Basic Info and Price
+
 ```bash
-# Basic token info
-gmgn-cli token info --chain sol --address <token_address>
+# Get current price and market cap for a SOL token
+gmgn-cli token info --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

-# Security metrics
-gmgn-cli token security --chain sol --address <token_address>
+# Get basic info for a BSC token
+gmgn-cli token info --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD959F933F8

-# Liquidity pool
-gmgn-cli token pool --chain sol --address <token_address>
+# Get basic info for a Base token
+gmgn-cli token info --chain base --address 0x4200000000000000000000000000000000000006

-# Top holders
-gmgn-cli token holders --chain sol --address <token_address>
-gmgn-cli token holders --chain sol --address <token_address> --limit 50
+# Raw JSON output for downstream processing
+gmgn-cli token info --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --raw
+```

-# Top traders
-gmgn-cli token traders --chain sol --address <token_address>
-gmgn-cli token traders --chain sol --address <token_address> --limit 50
+### `token security` — Check Safety Before Buying

-# Raw JSON output (for piping)
+```bash
+# Check if a SOL token has renounced mint + freeze authority
+gmgn-cli token security --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
+
+# Check if a BSC token is honeypot and whether contract is verified
+gmgn-cli token security --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD959F933F8
+
+# Check a Base token for tax, rug ratio, and insider concentration
+gmgn-cli token security --chain base --address 0x4200000000000000000000000000000000000006
+
+# Raw output for parsing key fields (e.g. is_honeypot, buy_tax, rug_ratio)
+gmgn-cli token security --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD959F933F8 --raw
+```
+
+### `token pool` — Check Liquidity Depth
+
+```bash
+# Get pool info for a SOL token (liquidity, reserves, DEX)
+gmgn-cli token pool --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
+
+# Get pool info for a BSC token
+gmgn-cli token pool --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD959F933F8
+```
+
+### `token holders` — Analyze Holder Distribution
+
+```bash
+# Top 20 holders by supply percentage (default)
+gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
+
+# Top 50 holders sorted by percentage held
+gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --limit 50 --order-by amount_percentage --direction desc
+
+# Top 50 smart money holders (highest conviction wallets)
+gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --limit 50 --tag smart_degen --order-by amount_percentage
+
+# Top KOL wallets ranked by realized profit (who has already taken profit)
+gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --tag renowned --order-by profit --direction desc --limit 20
+
+# Smart money with most unrealized profit (who is sitting on biggest gains)
+gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --tag smart_degen --order-by unrealized_profit --direction desc --limit 20
+
+# Holders who have been buying the most recently (buy momentum signal)
+gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --tag smart_degen --order-by buy_volume_cur --direction desc --limit 20
+
+# Holders who are selling the most (exit signal / distribution warning)
+gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --tag renowned --order-by sell_volume_cur --direction desc --limit 20
+
+# BSC token holders — KOL wallets by profit
+gmgn-cli token holders --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD959F933F8 \
+  --tag renowned --order-by profit --direction desc --limit 50
+
+# Raw output for downstream analysis
+gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --limit 100 --raw
+```
+
+### `token traders` — Find Active Traders
+
+```bash
+# Top 20 active traders by supply held (default)
+gmgn-cli token traders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
+
+# Smart money traders ranked by realized profit
+gmgn-cli token traders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --tag smart_degen --order-by profit --direction desc --limit 50
+
+# KOL traders ranked by unrealized profit (still holding with paper gains)
+gmgn-cli token traders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --tag renowned --order-by unrealized_profit --direction desc --limit 20
+
+# Smart money traders with highest buy volume (aggressive accumulation)
+gmgn-cli token traders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --tag smart_degen --order-by buy_volume_cur --direction desc --limit 20
+
+# Smart money traders ranked by sell volume (who is distributing)
+gmgn-cli token traders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --tag smart_degen --order-by sell_volume_cur --direction desc --limit 20
+
+# Worst performing KOL traders (who lost the most — contrarian signal)
+gmgn-cli token traders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --tag renowned --order-by profit --direction asc --limit 20
+
+# BSC token traders by profit
+gmgn-cli token traders --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD959F933F8 \
+  --tag smart_degen --order-by profit --direction desc --limit 50
+```
+
+---
+
+## Workflow: Full Token Due Diligence
+
+Use this workflow before deciding to buy a token.
+
+### Step 1 — Get basic info
+
+```bash
 gmgn-cli token info --chain sol --address <token_address> --raw
 ```

+Check: `price`, `liquidity`, `holder_count`, `wallet_tags_stat.smart_wallets`, `wallet_tags_stat.renowned_wallets`, `link.website` / `link.twitter_username` / `link.telegram`.
+
+**Red flags**: all `link.*` social fields empty, very low liquidity (<$10k), zero `wallet_tags_stat.smart_wallets` and `renowned_wallets`.
+
+### Step 2 — Check security
+
+```bash
+gmgn-cli token security --chain sol --address <token_address> --raw
+```
+
+Check these fields and their safe thresholds:
+
+| Field | Safe | Warning | Danger |
+|-------|------|---------|--------|
+| `is_honeypot` | `"no"` | — | `"yes"` → Do not buy |
+| `open_source` | `"yes"` | `"unknown"` | `"no"` |
+| `owner_renounced` | `"yes"` | `"unknown"` | `"no"` |
+| `renounced_mint` (SOL) | `true` | — | `false` → mint risk |
+| `renounced_freeze_account` (SOL) | `true` | — | `false` → freeze risk |
+| `buy_tax` / `sell_tax` | `0` | `0.01–0.05` | `>0.10` → high tax |
+| `top_10_holder_rate` | `<0.20` | `0.20–0.40` | `>0.50` → whale risk |
+| `rug_ratio` | `<0.10` | `0.10–0.30` | `>0.30` → high rug risk |
+| `creator_token_status` | `creator_close` | — | `creator_hold` → dev not sold |
+| `sniper_count` | `<5` | `5–20` | `>20` → heavily sniped |
+
+### Step 3 — Check liquidity pool
+
+```bash
+gmgn-cli token pool --chain sol --address <token_address> --raw
+```
+
+Check: liquidity amount, which DEX (`exchange`), pool age (`creation_timestamp`). Low liquidity means high slippage risk when buying or selling.
+
+### Step 4 — Check smart money signals
+
+```bash
+# Is smart money accumulating?
+gmgn-cli token holders --chain sol --address <token_address> \
+  --tag smart_degen --order-by buy_volume_cur --direction desc --limit 20 --raw
+
+# Have KOLs already taken profit?
+gmgn-cli token traders --chain sol --address <token_address> \
+  --tag renowned --order-by profit --direction desc --limit 20 --raw
+```
+
+**Bullish signals**: smart_degen wallets buying heavily, unrealized_profit is large (still holding), renowned wallets accumulating, low sell_volume_cur.
+
+**Bearish signals**: sell_volume_cur > buy_volume_cur for smart money, large realized profits already taken (they may be done), top holders with very high amount_percentage starting to sell.
+
+---
+
 ## Notes

+- **Market cap is not returned directly** — calculate it as `price × circulating_supply` (both fields are top-level; `circulating_supply` is already in human-readable token units, no decimal adjustment needed). Example: `price=3.11` × `circulating_supply=999999151` ≈ $3.11B market cap.
+- **Trading volume (1h, 24h, etc.) is not included in `token info`** — to get volume or OHLCV data, use the `gmgn-market` skill and query K-line data: `gmgn-cli market kline --chain <chain> --address <token_address> --resolution <1m|5m|15m|1h|4h|1d>`. See the `gmgn-market` SKILL.md for full details.
 - All token commands use normal auth (API Key only, no signature required)
 - Use `--raw` to get single-line JSON for further processing
- **Input validation** — Token addresses from API responses are treated as external data. Validate that addresses match the expected chain format (sol: base58 32–44 chars; bsc/base/eth: `0x` + 40 hex digits) before passing them to commands. The CLI enforces this at runtime and will exit with an error on invalid input.
+- `--tag` applies to both `holders` and `traders` and filters to only wallets with that tag — if few results are returned, try the other tag value
+- `amount_percentage` in holders/traders is a ratio (0–1), not a percentage — `0.05` means 5% of supply
+- **Input validation** — Token addresses are external data. Validate that addresses match the expected chain format (sol: base58 32–44 chars; bsc/base/eth: `0x` + 40 hex digits) before passing them to commands. The CLI enforces this at runtime and will exit with an error on invalid input.
@@ -0,0 +1,114 @@
+---
+name: gmgn-track
+description: Query GMGN on-chain tracking data — follow-wallet trade records, KOL trades, and Smart Money trades. Supports sol / bsc / base.
+argument-hint: "<follow-wallet|kol|smartmoney> [--chain <sol|bsc|base>] [--wallet <wallet_address>]"
+---
+
+**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.**
+
+Use the `gmgn-cli` tool to query on-chain tracking data based on the user's request.
+
+**When to use which sub-command:**
+- `track follow-wallet` — user asks "what did the wallets I follow trade?", "show me my follow list trades", "追踪关注的钱包交易动态" → requires wallets followed via GMGN platform
+- `track kol` — user asks "what are KOLs buying?", "KOL 最近在买什么", "show me influencer trades" → returns trades from known KOL wallets
+- `track smartmoney` — user asks "what is smart money doing?", "聪明钱最近在买什么", "show me whale trades" → returns trades from smart money / whale wallets
+
+**Do NOT confuse these three:**
+- `follow-wallet` = wallets the user has personally followed on GMGN
+- `kol` = platform-tagged KOL / influencer wallets (not user-specific)
+- `smartmoney` = platform-tagged smart money / whale wallets (not user-specific)
+
+## Sub-commands
+
+| Sub-command | Description |
+|-------------|-------------|
+| `track follow-wallet` | Trade records from wallets the user personally follows on GMGN |
+| `track kol` | Real-time trades from KOL / influencer wallets tagged by GMGN |
+| `track smartmoney` | Real-time trades from smart money / whale wallets tagged by GMGN |
+
+## Supported Chains
+
+`sol` / `bsc` / `base`
+
+## Prerequisites
+
+- `.env` file with `GMGN_API_KEY` set
+- `GMGN_PRIVATE_KEY` required for `track follow-wallet` (signature auth); not needed for `track kol` / `track smartmoney`
+- Run from the directory where your `.env` file is located, or set `GMGN_HOST` in your environment
+- `gmgn-cli` installed globally: `npm install -g gmgn-cli`
+
+## Usage Examples
+
+```bash
+# Follow-wallet trades (all wallets you follow)
+gmgn-cli track follow-wallet --chain sol
+
+# Follow-wallet trades filtered by wallet
+gmgn-cli track follow-wallet --chain sol --wallet <wallet_address>
+
+# Follow-wallet filtered by trade direction
+gmgn-cli track follow-wallet --chain sol --side buy
+
+# Follow-wallet filtered by USD amount range
+gmgn-cli track follow-wallet --chain sol --min-amount-usd 100 --max-amount-usd 10000
+
+# KOL trade records (SOL, default)
+gmgn-cli track kol --limit 10 --raw
+
+# KOL trade records on SOL, buy only
+gmgn-cli track kol --chain sol --side buy --limit 10 --raw
+
+# Smart Money trade records (SOL, default)
+gmgn-cli track smartmoney --limit 10 --raw
+
+# Smart Money trade records, sell only
+gmgn-cli track smartmoney --chain sol --side sell --limit 10 --raw
+```
+
+## `track follow-wallet` Options
+
+| Option | Description |
+|--------|-------------|
+| `--chain` | Required. `sol` / `bsc` / `base` |
+| `--wallet <address>` | Filter by wallet address |
+| `--limit <n>` | Page size (1–100, default 10) |
+| `--side <side>` | Trade direction: `buy` / `sell` |
+| `--filter <tag...>` | Repeatable filter conditions |
+| `--min-amount-usd <n>` | Minimum trade amount (USD) |
+| `--max-amount-usd <n>` | Maximum trade amount (USD) |
+
+## `track kol` / `track smartmoney` Options
+
+| Option | Description |
+|--------|-------------|
+| `--chain <chain>` | Chain: `sol` / `bsc` / `base` (default `sol`) |
+| `--limit <n>` | Page size (1–200, default 100) |
+| `--side <side>` | Filter by trade direction: `buy` / `sell` (client-side filter — applied locally after fetching results) |
+
+## `track kol` / `track smartmoney` Response Fields
+
+Each item in `list` contains:
+
+| Field | Description |
+|-------|-------------|
+| `transaction_hash` | On-chain transaction hash |
+| `maker` | Wallet address of the trader (KOL / Smart Money) |
+| `side` | Trade direction: `buy` or `sell` |
+| `base_address` | Token contract address |
+| `base_token.symbol` | Token ticker symbol |
+| `base_token.launchpad` | Launchpad platform (e.g. `pump`) |
+| `amount_usd` | Trade value in USD |
+| `token_amount` | Token quantity traded |
+| `price_usd` | Token price in USD at time of trade |
+| `buy_cost_usd` | Original buy cost in USD (0 if this record is the buy) |
+| `is_open_or_close` | `0` = position opened / added, `1` = position closed / reduced |
+| `timestamp` | Unix timestamp of the trade |
+| `maker_info.twitter_username` | KOL's Twitter username |
+| `maker_info.tags` | Wallet tags (e.g. `kol`, `smart_degen`, `photon`) |
+
+## Notes
+
+- `track kol` / `track smartmoney` use normal auth (API Key only, no signature required)
+- `track follow-wallet` requires `GMGN_PRIVATE_KEY` for signature auth — and wallets must be followed via the GMGN platform first
+- Use `--raw` to get single-line JSON for further processing
+- `track kol` / `track smartmoney` `--side` is a **client-side filter** — the CLI fetches all results then filters locally; it is NOT sent to the API
@@ -61,12 +61,12 @@ export class OpenApiClient {
    return this.normalRequest("GET", "/v1/token/pool_info", { chain, address });
  }

-  async getTokenTopHolders(chain: string, address: string): Promise<unknown> {
-    return this.normalRequest("GET", "/v1/market/token_top_holders", { chain, address });
+  async getTokenTopHolders(chain: string, address: string, extra: Record<string, string | number> = {}): Promise<unknown> {
+    return this.normalRequest("GET", "/v1/market/token_top_holders", { chain, address, ...extra });
  }

-  async getTokenTopTraders(chain: string, address: string): Promise<unknown> {
-    return this.normalRequest("GET", "/v1/market/token_top_traders", { chain, address });
+  async getTokenTopTraders(chain: string, address: string, extra: Record<string, string | number> = {}): Promise<unknown> {
+    return this.normalRequest("GET", "/v1/market/token_top_traders", { chain, address, ...extra });
  }

  // ---- Market endpoints (normal auth) ----
@@ -75,10 +75,13 @@ export class OpenApiClient {
    chain: string,
    address: string,
    resolution: string,
-    from: number,
-    to: number
+    from?: number,
+    to?: number
  ): Promise<unknown> {
-    return this.normalRequest("GET", "/v1/market/token_kline", { chain, address, resolution, from, to });
+    const query: Record<string, string | number> = { chain, address, resolution };
+    if (from != null) query["from"] = from;
+    if (to != null) query["to"] = to;
+    return this.normalRequest("GET", "/v1/market/token_kline", query);
  }

  // ---- Portfolio endpoints (normal auth) ----
@@ -123,6 +126,11 @@ export class OpenApiClient {
    return this.normalRequest("GET", "/v1/user/wallet_token_balance", { chain, wallet_address: walletAddress, token_address: tokenAddress });
  }

+  async getTrenches(chain: string, types?: string[], platforms?: string[], limit?: number): Promise<unknown> {
+    const body = buildTrenchesBody(chain, types, platforms, limit);
+    return this.normalRequest("POST", "/v1/trenches", { chain }, body);
+  }
+
  // ---- Market trending endpoints (normal auth) ----

  async getTrendingSwaps(
@@ -139,6 +147,37 @@ export class OpenApiClient {
    return this.normalRequest("GET", "/v1/user/info", {});
  }

+  async getFollowWallet(chain: string, extra: Record<string, string | number | string[]> = {}): Promise<unknown> {
+    return this.criticalRequest("GET", "/v1/trade/follow_wallet", { chain, ...extra }, null);
+  }
+
+  async getKol(chain?: string, limit?: number): Promise<unknown> {
+    const query: Record<string, string | number> = {};
+    if (chain) query["chain"] = chain;
+    if (limit != null) query["limit"] = limit;
+    return this.normalRequest("GET", "/v1/user/kol", query);
+  }
+
+  async getSmartMoney(chain?: string, limit?: number): Promise<unknown> {
+    const query: Record<string, string | number> = {};
+    if (chain) query["chain"] = chain;
+    if (limit != null) query["limit"] = limit;
+    return this.normalRequest("GET", "/v1/user/smartmoney", query);
+  }
+
+  async quoteOrder(
+    chain: string,
+    from_address: string,
+    input_token: string,
+    output_token: string,
+    input_amount: string,
+    slippage: number
+  ): Promise<unknown> {
+    return this.normalRequest("GET", "/v1/trade/quote", {
+      chain, from_address, input_token, output_token, input_amount, slippage,
+    });
+  }
+
  // ---- Swap endpoints (critical auth) ----

  async swap(params: SwapParams): Promise<unknown> {
@@ -269,6 +308,49 @@ function formatCurl(method: string, url: string, headers: Record<string, string>
  return `\n[curl]\ncurl -X ${method} '${url}' \\\n${headerArgs}${bodyArg}\n`;
 }

+const TRENCHES_PLATFORMS: Record<string, string[]> = {
+  sol: [
+    "Pump.fun", "pump_mayhem", "pump_mayhem_agent", "pump_agent",
+    "letsbonk", "bonkers", "bags", "memoo", "liquid", "bankr", "zora",
+    "surge", "anoncoin", "moonshot_app", "wendotdev", "heaven", "sugar",
+    "token_mill", "believe", "trendsfun", "trends_fun", "jup_studio",
+    "Moonshot", "boop", "ray_launchpad", "meteora_virtual_curve", "xstocks",
+  ],
+  bsc: [
+    "fourmeme", "fourmeme_agent", "bn_fourmeme", "four_xmode_agent",
+    "flap", "clanker", "lunafun",
+  ],
+  base: [
+    "clanker", "bankr", "flaunch", "zora", "zora_creator",
+    "baseapp", "basememe", "virtuals_v2", "klik",
+  ],
+};
+
+const TRENCHES_QUOTE_ADDRESS_TYPES: Record<string, number[]> = {
+  sol:  [4, 5, 3, 1, 13, 0],
+  bsc:  [6, 7, 1, 16, 8, 3, 9, 10, 2, 17, 18, 0],
+  base: [11, 3, 12, 13, 0],
+};
+
+function buildTrenchesBody(chain: string, types?: string[], platforms?: string[], limit?: number): Record<string, unknown> {
+  const selectedTypes = types?.length ? types : ["new_creation", "near_completion", "completed"];
+  const launchpad_platform = platforms?.length ? platforms : (TRENCHES_PLATFORMS[chain] ?? []);
+  const quote_address_type = TRENCHES_QUOTE_ADDRESS_TYPES[chain] ?? [];
+  const actualLimit = limit ?? 80;
+  const section = {
+    filters: ["offchain", "onchain"],
+    launchpad_platform,
+    quote_address_type,
+    launchpad_platform_v2: true,
+    limit: actualLimit,
+  };
+  const body: Record<string, unknown> = { version: "v2" };
+  for (const type of selectedTypes) {
+    body[type] = { ...section };
+  }
+  return body;
+}
+
 function buildUrl(base: string, query: Record<string, string | number | string[]>): string {
  const params = new URLSearchParams();
  for (const [k, v] of Object.entries(query)) {
@@ -13,15 +13,21 @@ export function registerMarketCommands(program: Command): void {
    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
    .requiredOption("--address <address>", "Token contract address")
    .requiredOption("--resolution <resolution>", "Candlestick resolution: 1m / 5m / 15m / 1h / 4h / 1d")
-    .requiredOption("--from <timestamp>", "Start time (Unix seconds)", parseInt)
-    .requiredOption("--to <timestamp>", "End time (Unix seconds)", parseInt)
+    .option("--from <timestamp>", "Start time (Unix seconds)", parseInt)
+    .option("--to <timestamp>", "End time (Unix seconds)", parseInt)
    .option("--raw", "Output raw JSON")
    .action(async (opts) => {
      validateChain(opts.chain);
      validateAddress(opts.address, opts.chain, "--address");
      const client = new OpenApiClient(getConfig());
      const data = await client
-        .getTokenKline(opts.chain, opts.address, opts.resolution, opts.from * 1000, opts.to * 1000)
+        .getTokenKline(
+          opts.chain,
+          opts.address,
+          opts.resolution,
+          opts.from != null ? opts.from * 1000 : undefined,
+          opts.to != null ? opts.to * 1000 : undefined
+        )
        .catch(exitOnError);
      printResult(data, opts.raw);
    });
@@ -30,18 +36,18 @@ export function registerMarketCommands(program: Command): void {
    .command("trending")
    .description("Get trending token swap data")
    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
-    .requiredOption("--interval <interval>", "Time interval: 1h / 3h / 6h / 24h")
+    .requiredOption("--interval <interval>", "Time interval: 1m / 5m / 1h / 6h / 24h")
    .option("--limit <n>", "Number of results (default 100, max 100)", parseInt)
-    .option("--orderby <field>", "Sort field: score / volume / swaps / liquidity / marketcap / holders / price / change / ...")
+    .option("--order-by <field>", "Sort field: default / volume / swaps / marketcap / holder_count / price / change1h / ... (see docs for full list)")
    .option("--direction <dir>", "Sort direction: asc / desc")
-    .option("--filter <tag...>", "Filter tags, repeatable: has_social / not_risk / not_honeypot / verified / locked / renounced / ...")
-    .option("--platform <name...>", "Platform filter, repeatable: pump / moonshot / ...")
+    .option("--filter <tag...>", "Filter tags, repeatable. sol: renounced / frozen / has_social / not_wash_trading / ... evm: not_honeypot / verified / renounced / locked / ... (see docs for full list)")
+    .option("--platform <name...>", "Platform filter, repeatable. sol: Pump.fun / letsbonk / moonshot_app / ... bsc: fourmeme / flap / clanker / ... base: clanker / flaunch / zora / ... (see docs for full list)")
    .option("--raw", "Output raw JSON")
    .action(async (opts) => {
      validateChain(opts.chain);
      const extra: Record<string, string | number | string[]> = {};
      if (opts.limit != null) extra["limit"] = opts.limit;
-      if (opts.orderby) extra["order_by"] = opts.orderby;
+      if (opts.orderBy) extra["order_by"] = opts.orderBy;
      if (opts.direction) extra["direction"] = opts.direction;
      if (opts.filter?.length) extra["filters"] = opts.filter;
      if (opts.platform?.length) extra["platforms"] = opts.platform;
@@ -50,5 +56,20 @@ export function registerMarketCommands(program: Command): void {
      const data = await client.getTrendingSwaps(opts.chain, opts.interval, extra).catch(exitOnError);
      printResult(data, opts.raw);
    });
+
+  market
+    .command("trenches")
+    .description("Get Trenches token data (new creation, near completion, completed)")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .option("--type <type...>", "Categories to query, repeatable: new_creation / near_completion / completed (default: all three)")
+    .option("--launchpad-platform <platform...>", "Launchpad platform filter, repeatable (default: all platforms for the chain)")
+    .option("--limit <n>", "Max results per category, max 80 (default: 80)", parseInt)
+    .option("--raw", "Output raw JSON")
+    .action(async (opts) => {
+      validateChain(opts.chain);
+      const client = new OpenApiClient(getConfig());
+      const data = await client.getTrenches(opts.chain, opts.type, opts.launchpadPlatform, opts.limit).catch(exitOnError);
+      printResult(data, opts.raw);
+    });
 }

@@ -14,7 +14,7 @@ export function registerPortfolioCommands(program: Command): void {
    .requiredOption("--wallet <address>", "Wallet address")
    .option("--limit <n>", "Page size (default 20, max 50)", parseInt, 20)
    .option("--cursor <cursor>", "Pagination cursor")
-    .option("--order-by <field>", "Sort field: usd_value / price / price_change / unrealized_profit / realized_profit / ...", "usd_value")
+    .option("--order-by <field>", "Sort field: usd_value / last_active_timestamp / realized_profit / unrealized_profit / total_profit / history_bought_cost / history_sold_income", "usd_value")
    .option("--direction <dir>", "Sort direction: asc / desc", "desc")
    .option("--interval <interval>", "Stats interval (default 24h)")
    .option("--sell-out", "Include sold-out positions")
@@ -62,7 +62,7 @@ export function registerPortfolioCommands(program: Command): void {
      validateAddress(opts.wallet, opts.chain, "--wallet");
      if (opts.token) validateAddress(opts.token, opts.chain, "--token");
      const extra: Record<string, string | number | string[]> = {};
-      if (opts.token) extra["token"] = opts.token;
+      if (opts.token) extra["token_address"] = opts.token;
      if (opts.limit != null) extra["limit"] = opts.limit;
      if (opts.cursor) extra["cursor"] = opts.cursor;
      if (opts.type?.length) extra["type"] = opts.type;
@@ -112,5 +112,6 @@ export function registerPortfolioCommands(program: Command): void {
      const data = await client.getWalletTokenBalance(opts.chain, opts.wallet, opts.token).catch(exitOnError);
      printResult(data, opts.raw);
    });
+
 }

@@ -15,6 +15,7 @@ export function registerSwapCommands(program: Command): void {
    .option("--amount <amount>", "Input raw amount (smallest unit)")
    .option("--percent <pct>", "Input amount as a percentage, e.g. 50 = 50%, 1 = 1%; only valid when input_token is NOT a currency", parseFloat)
    .option("--slippage <n>", "Slippage tolerance (e.g. 0.01 = 1%)", parseFloat)
+    .option("--auto-slippage", "Enable automatic slippage")
    .option("--min-output <amount>", "Minimum output amount")
    .option("--anti-mev", "Enable anti-MEV protection, default true")
    .option("--priority-fee <sol>", "Priority fee in SOL (≥ 0.00001, SOL only)")
@@ -44,6 +45,7 @@ export function registerSwapCommands(program: Command): void {
      };
      if (opts.percent != null) params.input_amount_bps = String(Math.round(opts.percent * 100));
      if (opts.slippage != null) params.slippage = opts.slippage;
+      if (opts.autoSlippage) params.auto_slippage = true;
      if (opts.minOutput) params.min_output_amount = opts.minOutput;
      if (opts.antiMev) params.is_anti_mev = true;
      if (opts.priorityFee) params.priority_fee = opts.priorityFee;
@@ -60,6 +62,29 @@ export function registerSwapCommands(program: Command): void {

  const order = program.command("order").description("Order management commands");

+  order
+    .command("quote")
+    .description("Get a swap quote without submitting a transaction")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--from <address>", "Wallet address (must match API Key binding)")
+    .requiredOption("--input-token <address>", "Input token contract address")
+    .requiredOption("--output-token <address>", "Output token contract address")
+    .requiredOption("--amount <amount>", "Input amount (smallest unit)")
+    .requiredOption("--slippage <n>", "Slippage tolerance (e.g. 0.01 = 1%)", parseFloat)
+    .option("--raw", "Output raw JSON")
+    .action(async (opts) => {
+      validateChain(opts.chain);
+      validateAddress(opts.from, opts.chain, "--from");
+      validateAddress(opts.inputToken, opts.chain, "--input-token");
+      validateAddress(opts.outputToken, opts.chain, "--output-token");
+      validatePositiveInt(opts.amount, "--amount");
+      const client = new OpenApiClient(getConfig());
+      const data = await client
+        .quoteOrder(opts.chain, opts.from, opts.inputToken, opts.outputToken, opts.amount, opts.slippage)
+        .catch(exitOnError);
+      printResult(data, opts.raw);
+    });
+
  order
    .command("get")
    .description("Query order status (requires private key)")
@@ -73,4 +98,3 @@ export function registerSwapCommands(program: Command): void {
      printResult(data, opts.raw);
    });
 }
-
@@ -54,12 +54,21 @@ export function registerTokenCommands(program: Command): void {
    .description("Get top token holders")
    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
    .requiredOption("--address <address>", "Token contract address")
+    .option("--limit <n>", "Number of results (default 20, max 100)", parseInt)
+    .option("--order-by <field>", "Sort field: amount_percentage / profit / unrealized_profit / buy_volume_cur / sell_volume_cur", "amount_percentage")
+    .option("--direction <dir>", "Sort direction: asc / desc", "desc")
+    .option("--tag <tag>", "Wallet tag filter: renowned / smart_degen", "renowned")
    .option("--raw", "Output raw JSON")
    .action(async (opts) => {
      validateChain(opts.chain);
      validateAddress(opts.address, opts.chain, "--address");
+      const extra: Record<string, string | number> = {};
+      if (opts.limit != null) extra["limit"] = opts.limit;
+      if (opts.orderBy) extra["order_by"] = opts.orderBy;
+      if (opts.direction) extra["direction"] = opts.direction;
+      if (opts.tag) extra["tag"] = opts.tag;
      const client = new OpenApiClient(getConfig());
-      const data = await client.getTokenTopHolders(opts.chain, opts.address).catch(exitOnError);
+      const data = await client.getTokenTopHolders(opts.chain, opts.address, extra).catch(exitOnError);
      printResult(data, opts.raw);
    });

@@ -68,12 +77,21 @@ export function registerTokenCommands(program: Command): void {
    .description("Get top token traders")
    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
    .requiredOption("--address <address>", "Token contract address")
+    .option("--limit <n>", "Number of results (default 20, max 100)", parseInt)
+    .option("--order-by <field>", "Sort field: amount_percentage / profit / unrealized_profit / buy_volume_cur / sell_volume_cur", "amount_percentage")
+    .option("--direction <dir>", "Sort direction: asc / desc", "desc")
+    .option("--tag <tag>", "Wallet tag filter: renowned / smart_degen", "renowned")
    .option("--raw", "Output raw JSON")
    .action(async (opts) => {
      validateChain(opts.chain);
      validateAddress(opts.address, opts.chain, "--address");
+      const extra: Record<string, string | number> = {};
+      if (opts.limit != null) extra["limit"] = opts.limit;
+      if (opts.orderBy) extra["order_by"] = opts.orderBy;
+      if (opts.direction) extra["direction"] = opts.direction;
+      if (opts.tag) extra["tag"] = opts.tag;
      const client = new OpenApiClient(getConfig());
-      const data = await client.getTokenTopTraders(opts.chain, opts.address).catch(exitOnError);
+      const data = await client.getTokenTopTraders(opts.chain, opts.address, extra).catch(exitOnError);
      printResult(data, opts.raw);
    });
 }
@@ -0,0 +1,68 @@
+import { Command } from "commander";
+import { OpenApiClient } from "../client/OpenApiClient.js";
+import { getConfig } from "../config.js";
+import { exitOnError, printResult } from "../output.js";
+import { validateChain } from "../validate.js";
+
+export function registerTrackCommands(program: Command): void {
+  const track = program.command("track").description("On-chain tracking commands: follow-wallet trades, KOL trades, Smart Money trades");
+
+  track
+    .command("follow-wallet")
+    .description("Get follow-wallet trade records")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .option("--wallet <address>", "Filter by wallet address")
+    .option("--limit <n>", "Page size (1–100, default 10)", parseInt)
+    .option("--side <side>", "Trade direction filter: buy / sell")
+    .option("--filter <tag...>", "Filter conditions, repeatable")
+    .option("--min-amount-usd <n>", "Minimum trade amount (USD)", parseFloat)
+    .option("--max-amount-usd <n>", "Maximum trade amount (USD)", parseFloat)
+    .option("--raw", "Output raw JSON")
+    .action(async (opts) => {
+      validateChain(opts.chain);
+      const extra: Record<string, string | number | string[]> = {};
+      if (opts.wallet) extra["wallet_address"] = opts.wallet;
+      if (opts.limit != null) extra["limit"] = opts.limit;
+      if (opts.side) extra["side"] = opts.side;
+      if (opts.filter?.length) extra["filters"] = opts.filter;
+      if (opts.minAmountUsd != null) extra["min_amount_usd"] = opts.minAmountUsd;
+      if (opts.maxAmountUsd != null) extra["max_amount_usd"] = opts.maxAmountUsd;
+      const client = new OpenApiClient(getConfig(true));
+      const data = await client.getFollowWallet(opts.chain, extra).catch(exitOnError);
+      printResult(data, opts.raw);
+    });
+
+  track
+    .command("kol")
+    .description("Get KOL trade records")
+    .option("--chain <chain>", "Chain: sol / bsc / base")
+    .option("--limit <n>", "Page size (1–200, default 100)", parseInt)
+    .option("--side <side>", "Filter by trade direction: buy / sell (client-side filter)")
+    .option("--raw", "Output raw JSON")
+    .action(async (opts) => {
+      if (opts.chain) validateChain(opts.chain);
+      const client = new OpenApiClient(getConfig());
+      const data = await client.getKol(opts.chain, opts.limit).catch(exitOnError) as { list?: { side: string }[] };
+      if (opts.side && data?.list) {
+        data.list = data.list.filter((item) => item.side === opts.side);
+      }
+      printResult(data, opts.raw);
+    });
+
+  track
+    .command("smartmoney")
+    .description("Get Smart Money trade records")
+    .option("--chain <chain>", "Chain: sol / bsc / base")
+    .option("--limit <n>", "Page size (1–200, default 100)", parseInt)
+    .option("--side <side>", "Filter by trade direction: buy / sell (client-side filter)")
+    .option("--raw", "Output raw JSON")
+    .action(async (opts) => {
+      if (opts.chain) validateChain(opts.chain);
+      const client = new OpenApiClient(getConfig());
+      const data = await client.getSmartMoney(opts.chain, opts.limit).catch(exitOnError) as { list?: { side: string }[] };
+      if (opts.side && data?.list) {
+        data.list = data.list.filter((item) => item.side === opts.side);
+      }
+      printResult(data, opts.raw);
+    });
+}
@@ -8,6 +8,7 @@ import { Command } from "commander";
 import { registerTokenCommands } from "./commands/token.js";
 import { registerMarketCommands } from "./commands/market.js";
 import { registerPortfolioCommands } from "./commands/portfolio.js";
+import { registerTrackCommands } from "./commands/track.js";
 import { registerSwapCommands } from "./commands/swap.js";

 const proxy = process.env.HTTPS_PROXY ?? process.env.https_proxy
@@ -50,6 +51,7 @@ program
 registerTokenCommands(program);
 registerMarketCommands(program);
 registerPortfolioCommands(program);
+registerTrackCommands(program);
 registerSwapCommands(program);

 program.parseAsync().catch((err) => {
Author	SHA1	Message	Date
gumponchain	fa2afae426	1.1.5	2026-03-27 15:54:47 +08:00
gumponchain	5fc9a86c4d	1.1.4	2026-03-27 15:22:07 +08:00
gumponchain	56f1f574b1	fix: remove pinned gmgn-cli version to always use latest Replace `npm install -g gmgn-cli@1.1.0` with `npm install -g gmgn-cli` across all SKILL.md files and CLAUDE.md, so users always install the latest published version instead of a pinned one that may lack newer commands (e.g. track). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-27 15:19:22 +08:00
gumponchain	28062887d8	feat: add track command group, split follow-wallet/kol/smartmoney from portfolio - Add new `track` command group with three sub-commands: - `track follow-wallet`: monitor trade activity of followed wallets (critical auth) - `track kol`: KOL trade records with optional --chain and client-side --side filter - `track smartmoney`: Smart Money trade records with optional --chain and client-side --side filter - Remove follow-wallet, kol, smartmoney sub-commands from portfolio - Add getKol/getSmartMoney optional chain param in OpenApiClient - Switch getFollowWallet to criticalRequest (signature auth required) - Align track follow-wallet options to actual API params (remove unsupported flags) - Add skills/gmgn-track/SKILL.md with sub-command guide, options, response fields - Add IMPORTANT notice to all SKILL.md files to prevent AI from scraping gmgn.ai - Add CRITICAL RULE section to CLAUDE.md to enforce CLI-only data access - Update Readme.md and Readme.zh.md: add gmgn-track skill, Track CLI section, user tip Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-27 14:19:57 +08:00
gumponchain	58849a8c61	docs: add upgrade tutorial section to README (en + zh) Add section 9 "Upgrade Skills and CLI" between Supported Chains and Security, covering AI Agent prompt, CLI commands, and version check for both languages. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-26 22:10:58 +08:00
gumponchain	0239e42b50	docs: enrich all SKILL.md files with response fields, usage examples, and AI-agent guidance - gmgn-token: full response field reference for all 5 sub-commands (token info nested objects pool/link/stat/wallet_tags_stat, security, pool, holders, traders); granular usage examples per scenario; full due diligence workflow with security threshold table; market cap calculation note; volume redirect to kline - gmgn-market: verified kline/trending response fields from live API; trending + platform filter examples for SOL/BSC/Base major launchpads; interval selection guide; trenches intent→type mapping table; standardized section headings with sub-command names - gmgn-portfolio/gmgn-swap: standardize section headings to include sub-command names - CLAUDE.md: add newly-launched token triggers for gmgn-market skill routing - Readme/Readme.zh: add missing portfolio sub-commands, kline examples, auto-slippage swap example; remove version pin; update install instructions Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-26 21:31:15 +08:00
deepfeature	12d3c358d8	Merge pull request #43 from GMGNAI/codex-update-github-repo-urls update GitHub repo urls	2026-03-26 19:53:23 +08:00
yangzhenhui	c6d55356a1	1.1.3	2026-03-26 19:10:15 +08:00
yangzhenhui	2c1c0210e7	1.1.2	2026-03-26 19:09:11 +08:00
yangzhenhui	71c239da39	Normalize GitHub repository URLs	2026-03-26 19:06:03 +08:00
yangzhenhui	0e5e5f8684	1.1.1	2026-03-26 17:42:42 +08:00
deepfeature	b8bc81d915	Merge pull request #41 from GumpOnchain/feat/trenches-custom-body feat(market): add structured options for trenches command	2026-03-26 17:09:48 +08:00
gumponchain	08b48c8e24	feat(market): add structured --type/--launchpad-platform/--limit options for trenches command Replace raw --body JSON parameter with structured CLI flags for better AI agent readability. Add full response key reference and SOL/BSC/Base examples to SKILL.md and docs. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-26 17:02:24 +08:00
deepfeature	5a8879c6d2	Merge pull request #40 from GMGNAI/codex-add-github-actions-workflows Add GitHub Actions CI and release workflows	2026-03-26 16:51:31 +08:00
yangzhenhui	30ce20ff01	Add GitHub Actions CI and release workflows	2026-03-26 16:44:44 +08:00
deepfeature	2b37e81d44	Merge pull request #39 from GMGNAI/copilot/add-auto-slippage-parameter Add `swap --auto-slippage` support and preserve manual slippage docs	2026-03-26 16:18:04 +08:00
copilot-swe-agent[bot]	c9b3034cf2	docs: restore manual slippage examples Co-authored-by: deepfeature <1503768+deepfeature@users.noreply.github.com> Agent-Logs-Url: https://github.com/GMGNAI/gmgn-skills/sessions/ae308c31-cf9d-4707-8848-a659112b33f4	2026-03-26 08:13:41 +00:00
copilot-swe-agent[bot]	2ca2c24f9e	docs: clarify auto-slippage examples Co-authored-by: deepfeature <1503768+deepfeature@users.noreply.github.com> Agent-Logs-Url: https://github.com/GMGNAI/gmgn-skills/sessions/b2089672-9ca8-402c-be14-138b55c1bb98	2026-03-26 07:54:11 +00:00
copilot-swe-agent[bot]	bd533cb85e	feat: add swap auto-slippage option Co-authored-by: deepfeature <1503768+deepfeature@users.noreply.github.com> Agent-Logs-Url: https://github.com/GMGNAI/gmgn-skills/sessions/b2089672-9ca8-402c-be14-138b55c1bb98	2026-03-26 07:52:26 +00:00
copilot-swe-agent[bot]	247aaf96f9	Initial plan	2026-03-26 07:50:07 +00:00
dev	45fb37d51f	support trenches & kol & smartmoney	2026-03-25 22:20:56 +08:00
dev	8301bf515f	upgrade version to 1.0.2	2026-03-25 21:22:59 +08:00
gumponchain	702eac9686	feat(market): update trending --interval to support 1m/5m/1h/6h/24h Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-25 16:46:55 +08:00
dev	34456974f3	fix rank interval	2026-03-24 20:48:23 +08:00
gumponchain	017672f480	docs: update README structure, add demo cases and screenshots - Restructure README (EN + ZH): reorder sections, unify sub-heading format - Add Demo Cases section with two annotated examples and screenshots - Add static/ folder with all screenshots and header image - Add Quick Start anchor link from Skills section to installation - Split Verify Connection into AI Agent and CLI options - Rename Prerequisites → Get Started / 准备工作 → 开始安装 Skills	2026-03-24 18:44:32 +08:00
dev	9d871e9166	fix order status	2026-03-24 10:25:12 +08:00
JhiNResH	d6b7247cc0	feat(swap): add pre-swap token safety check via Maiat API Adds a recommended pre-swap safety check section to gmgn-swap SKILL.md. Before swapping into unknown tokens, agents can verify honeypot/rug risk with a single curl call to Maiat's free API (no API key required). - Returns trustScore (0-100), verdict (proceed/caution/avoid), riskFlags - Zero dependencies — pure curl + jq - Works for any ERC-20 on Base	2026-03-18 16:10:45 +08:00
David Lau	c9dbb6f58b	fix: rename --orderby to --order-by, expand holders/traders options, update chain-specific platform/filter values	2026-03-18 16:07:10 +08:00