From a48205ea3fa4d897452e13c819327dfa717c4a1b Mon Sep 17 00:00:00 2001 From: gumponchain Date: Mon, 30 Mar 2026 11:06:15 +0800 Subject: [PATCH] docs: rewrite Why GMGN Skills into 4 structured blocks 1. Real-time on-chain data with K-line/trending granularity table 2. Trade speed (<0.3s, same RPC as web) 3. Unique token data fields (rat_trader, bundler, sniper, etc.) 4. Feature capability list Co-Authored-By: Claude Sonnet 4.6 --- Readme.md | 62 ++++++++++++++++++++++++++++++---------------------- Readme.zh.md | 62 ++++++++++++++++++++++++++++++---------------------- 2 files changed, 72 insertions(+), 52 deletions(-) diff --git a/Readme.md b/Readme.md index d986c6e..f83997e 100644 --- a/Readme.md +++ b/Readme.md @@ -16,38 +16,48 @@ With GMGN Agent Skills, you can use AI agents to query real-time trending token ## Why GMGN Skills -> Purpose-built for on-chain alpha — not a DeFi dashboard, not a general portfolio tracker. GMGN Skills gives AI agents access to the same professional data used by top traders on GMGN. +> Purpose-built for on-chain alpha. GMGN Skills gives AI agents direct access to the same professional data and trading infrastructure used by top traders on GMGN. -### Data that competitors don't have +### 1. Real-time on-chain data — faster -| Capability | GMGN Skills | Others | -|-----------|:-----------:|:------:| -| Smart Money historical P&L + win rate | ✅ | ❌ | -| Smart Money convergence signal (≥3 wallets / 30 min) | ✅ | ❌ | -| Wallet archetype tags (bundler / rat_trader / sniper / KOL / whale) | ✅ | Partial | -| Rug ratio score (0–1) + honeypot + wash-trade detection | ✅ | Basic only | -| Bonding curve lifecycle (pre-grad → graduated → open DEX) | ✅ | Partial | -| 1-minute K-line (OHLCV) | ✅ | ❌ | -| Strategy orders: take-profit / stop-loss | ✅ | ❌ | -| Sell by position percentage (`--percent 50`) | ✅ | ❌ | -| Follow-wallet live feed with size/direction filters | ✅ | ❌ | +Data across SOL / BSC / Base is live on every query. No polling delays, no stale snapshots. -### Built for speed +| Data | Granularity | +|------|-------------| +| K-line (OHLCV) | `1m` / `5m` / `15m` / `1h` / `4h` / `1d` — minimum **1-minute** candles | +| Trending tokens | `1m` / `5m` / `1h` / `6h` / `24h` — minimum **1-minute** window | +| Token price / volume / market cap | Real-time | +| Smart Money & KOL positions | Real-time | +| New token discovery (Trenches) | Real-time, by launchpad | -- **Real-time trading data** — Prices, swap counts, buy/sell volume, and market cap update in real time across SOL / BSC / Base. No stale snapshots. -- **Real-time token analytics** — Every query returns live-computed values for smart money count (`smart_degen`), KOL positions (`renowned`), rat trader ratio (`rat_trader_amount_rate`), bundler bot exposure (`bundler_trader_amount_rate`), sniper wallet count, suspected insider hold rate, and fresh wallet ratio — the same deep signal layer as the GMGN web platform. -- **Trade execution** — Shares the same RPC routing as GMGN's web trading interface. Order submission latency under 0.3 seconds. -- **Real-time data granularity** - - **K-line** (`market kline`): `1m` / `5m` / `15m` / `1h` / `4h` / `1d` — minimum **1-minute** candles, live-updated - - **Trending list** (`market trending`): `1m` / `5m` / `1h` / `6h` / `24h` — minimum **1-minute** window, refreshed every cycle +### 2. Trade faster -### Only on GMGN +- Same RPC routing as GMGN's web trading interface — order submission under **0.3 seconds**. +- Market orders, limit orders, and strategy orders (take-profit / stop-loss) in a single command. +- Sell by position percentage (`--percent 50`) without calculating exact amounts. -- **Smart Money convergence** — Surfaces tokens where ≥ 3 Smart Money wallets traded the same direction within 30 minutes — the strongest early-entry signal available. -- **Full wallet P&L breakdown** — Per-wallet realized profit, unrealized profit, average buy/sell price, win rate, and trade style profile. Know exactly how good a wallet is before you follow it. -- **Copy-trade estimation** — `workflow-smart-money-profile.md` calculates the historical return if you had mirrored a wallet trade-for-trade. -- **Multi-dimensional wallet tags** — Every holder is classified: smart_degen, renowned, sniper, rat_trader, bundler, whale, fresh wallet. No other skill exposes this. -- **9 built-in AI workflows** — Token research, project deep report, wallet analysis, smart money profiling, risk warning, early project screening, daily brief, market discovery, and more — all wired to the CLI. +### 3. More comprehensive token data + +Token queries return signals that most on-chain tools don't expose at all: + +- **Smart money count** (`smart_degen_count`) and **KOL holders** (`renowned_wallets`) — live +- **Rat trader ratio** (`rat_trader_amount_rate`) — volume share from insider/sneak wallets +- **Bundler bot exposure** (`bundler_trader_amount_rate`) — volume from bot-bundled buys +- **Sniper wallets** (`sniper_count`) — wallets that bought at the exact moment of launch +- **Suspected insider hold rate** (`suspected_insider_hold_rate`) +- **Fresh wallet ratio** (`fresh_wallet_rate`) +- **Rug ratio score** (0–1) + honeypot detection + wash-trade flag +- **Bonding curve status** (`is_on_curve`) — whether the token has graduated to open DEX + +### 4. What you can do with GMGN Skills + +- Query token fundamentals, security risk, liquidity pools, top holders, and top traders +- Fetch K-line / OHLCV data for any token across chains +- Browse trending tokens and newly launched tokens by launchpad (Pump.fun, letsbonk, fourmeme, clanker…) +- Analyze any wallet: holdings, realized / unrealized P&L, win rate, trade history +- Track Smart Money, KOL, and wallets you follow — see what they're buying and selling right now +- Run full research and analysis via 9 built-in AI workflow docs (token research, wallet analysis, risk warning, daily brief, and more) +- Execute swaps: market orders, limit orders, take-profit / stop-loss strategy orders --- diff --git a/Readme.zh.md b/Readme.zh.md index 1b94d16..7867fa8 100644 --- a/Readme.zh.md +++ b/Readme.zh.md @@ -16,38 +16,48 @@ ## 为什么选择 GMGN Skills -> 专为链上 Alpha 而生——不是 DeFi 数据大盘，不是通用钱包追踪器。GMGN Skills 让 AI Agent 直接调用顶级交易者在 GMGN 上使用的同一套专业数据。 +> 专为链上 Alpha 而生。GMGN Skills 让 AI Agent 直接调用 GMGN 顶级交易者使用的同一套专业数据与交易基础设施。 -### 竞品没有的数据 +### 1. 链上实时数据，更快 -| 能力 | GMGN Skills | 其他 | -|-----|:-----------:|:----:| -| 聪明钱历史盈亏 + 胜率 | ✅ | ❌ | -| 聪明钱聚集信号（≥3 个钱包 / 30 分钟内同向买入） | ✅ | ❌ | -| 钱包类型标签（bundler / 老鼠仓 / 狙击 / KOL / 巨鲸） | ✅ | 部分 | -| Rug 风险评分（0–1）+ 貔貅检测 + 对倒洗盘识别 | ✅ | 仅基础 | -| 代币生命周期追踪（Bonding Curve → 毕业 → 开放 DEX） | ✅ | 部分 | -| 1 分钟 K 线（OHLCV） | ✅ | ❌ | -| 策略单：止盈 / 止损 | ✅ | ❌ | -| 按仓位比例卖出（`--percent 50`） | ✅ | ❌ | -| 追踪关注钱包实时动态（支持金额/方向过滤） | ✅ | ❌ | +SOL / BSC / Base 多链数据每次查询均为实时，无轮询延迟，无缓存快照。 -### 为速度而生 +| 数据类型 | 粒度 | +|---------|------| +| K 线（OHLCV） | `1m` / `5m` / `15m` / `1h` / `4h` / `1d`，最低支持 **1 分钟** | +| 热门代币榜单 | `1m` / `5m` / `1h` / `6h` / `24h`，最低支持 **1 分钟**窗口 | +| 代币价格 / 交易量 / 市值 | 实时 | +| 聪明钱 & KOL 持仓 | 实时 | +| 新币发现（战壕） | 实时，按 Launchpad 平台分类 | -- **交易数据实时查** — SOL / BSC / Base 多链代币价格、交易量、买卖笔数、市值均实时更新，无缓存快照。 -- **代币特色数据实时分析** — 每次查询均实时计算：聪明钱数量（`smart_degen`）、KOL 持仓（`renowned`）、老鼠仓占比（`rat_trader_amount_rate`）、捆绑钱包暴露度（`bundler_trader_amount_rate`）、狙击钱包数（`sniper_count`）、疑似内幕持仓比（`suspected_insider_hold_rate`）、新钱包占比（`fresh_wallet_rate`）——与 GMGN 网页端相同的专业信号层。 -- **交易速度** — 与 GMGN 网页端共享同一套 RPC 路由，瞬间下单，提交延迟小于 0.3 秒。 -- **实时数据粒度** - - **K 线**（`market kline`）：`1m` / `5m` / `15m` / `1h` / `4h` / `1d`，最低支持 **1 分钟**粒度，实时更新 - - **热门榜单**（`market trending`）：`1m` / `5m` / `1h` / `6h` / `24h`，最低支持 **1 分钟**窗口，实时刷新 +### 2. 交易更快 -### 只有 GMGN 有的 +- 与 GMGN 网页端共享同一套 RPC 路由，下单延迟小于 **0.3 秒**。 +- 单条命令支持市价单、限价单、策略单（止盈 / 止损）。 +- 支持按仓位比例卖出（`--percent 50`），无需手动计算数量。 -- **聪明钱聚集信号** — 自动识别 30 分钟内 ≥ 3 个聪明钱同向交易的代币，最强的早期入场信号。 -- **钱包完整盈亏拆解** — 每个钱包的已实现盈利、未实现盈利、平均买入/卖出价格、胜率、交易风格画像。跟单前先看清楚这个钱包究竟有多强。 -- **跟单回测估算** — `workflow-smart-money-profile.md` 可计算如果完全镜像某个钱包的历史操作，你的历史收益率是多少。 -- **多维钱包标签体系** — 每个持币地址都有分类标签：聪明钱 / 知名 / 狙击手 / 老鼠仓 / Bundler / 巨鲸 / 新钱包。没有其他 Skill 暴露这层数据。 -- **9 个内置 AI 工作流** — 代币研究、项目深度报告、钱包分析、聪明钱画像、风险预警、早期项目筛选、每日简报、市场发现等，全部与 CLI 直连。 +### 3. 特色数据更全 + +代币查询返回多数链上工具从未暴露的专业信号： + +- **聪明钱数量**（`smart_degen_count`）和 **KOL 持仓**（`renowned_wallets`）— 实时 +- **老鼠仓占比**（`rat_trader_amount_rate`）— 内幕 / 偷跑钱包的交易量份额 +- **捆绑钱包暴露度**（`bundler_trader_amount_rate`）— 机器人捆绑买入的交易量占比 +- **狙击钱包数**（`sniper_count`）— 在代币刚开盘瞬间买入的钱包数量 +- **疑似内幕持仓比**（`suspected_insider_hold_rate`） +- **新钱包占比**（`fresh_wallet_rate`） +- **Rug 风险评分**（0–1）+ 貔貅检测 + 对倒洗盘识别 +- **Bonding Curve 状态**（`is_on_curve`）— 代币是否已毕业到开放 DEX + +### 4. 可以用 GMGN Skills 做什么 + +- 查询代币基础信息、安全风险、流动性池、Top 持仓、Top 交易者 +- 获取任意链上代币的 K 线 / OHLCV 数据 +- 浏览热门代币榜单，以及按 Launchpad 分类的新币（Pump.fun、letsbonk、fourmeme、clanker……） +- 分析任意钱包：持仓、已实现 / 未实现盈亏、胜率、交易历史 +- 追踪聪明钱、KOL 和关注钱包的实时动态，查看他们正在买卖什么 +- 通过 9 个内置 AI 工作流文档完成代币研究、钱包分析、风险预警、每日简报等完整流程 +- 执行交易：市价单、限价单、止盈止损策略单 ---