298 Commits

Author SHA1 Message Date
gumponchain aa27e1560a docs: improve Quick Start AI Agent flow to prevent early exit on demo key
Low-end models (e.g. Cursor default model) were stopping at Step 2
after seeing "the CLI is working", treating the demo key verification
as a success state and skipping the mandatory personal API key setup.

- Step 2: add explicit "Setup is NOT yet complete" warning after demo
  key verification, with "Do not stop here" directive
- Step 3: rename to "REQUIRED: Set up personal API key", add ⚠️ mandatory
  marker, change from passive "when the user asks" to imperative
  "immediately run without waiting for them to ask"

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-31 16:02:06 +08:00
dev d47404856d version to 1.1.8 v1.1.8 2026-03-30 15:42:10 +08:00
dev b898d20c29 version to 1.1.7 2026-03-30 15:41:03 +08:00
gumponchain 1e3fbaf623 docs(zh): add new token tracking line to section 4
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-30 12:06:56 +08:00
gumponchain 8bcb68aa3c docs(en): fully align Why GMGN Skills with Chinese version
- Update intro: 500+ dimensions, AI agent real-time chain scanning
- Expand section 1 table to match ZH (8 rows with full detail)
- Section 2: add multi-region deployment + best-route lines
- Section 3: add no-scraping/no-Cloudflare intro sentence
- Section 4: restructure into 5 groups, add new token tracking line

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-30 12:06:56 +08:00
gumponchain b995e84d16 docs(zh): rewrite section 4 to match updated sections 1-3
Grouped by use case: 实时查链 / 代币数据分析 / 钱包与追踪 /
自动化交易 / AI工作流,aligned with new data table and trade speed content.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-30 12:06:56 +08:00
gumponchain e4e331223e docs: rewrite Why GMGN Skills intro tagline (EN + ZH)
Emphasizes multi-chain Meme trading, 100+ data dimensions,
and 24/7 automated trading agent use case.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-30 12:06:56 +08:00
gumponchain a48205ea3f 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 <noreply@anthropic.com>
2026-03-30 12:06:56 +08:00
gumponchain 6a1dc62b6e docs: add Why GMGN Skills section to README (EN + ZH)
- Added competitive positioning section with data comparison table,
  speed advantages, and unique features
- Table trimmed to GMGN vs Others (2 columns) for clarity
- Speed section rewritten around real-time data, token analytics keywords,
  trade latency (<0.3s), and explicit K-line/trending granularity

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-30 12:06:56 +08:00
dev 4697985501 use ipv4 v1.1.7 2026-03-30 10:51:12 +08:00
gumponchain e0c4be2946 docs: add IPv6 diagnostic steps to README and all SKILL.md files
GMGN API does not support IPv6. When a 401/403 error occurs and
credentials look correct, AI agents and users now have a clear
two-step diagnostic: list inet6 interfaces, then probe
ipv6.icanhazip.com to confirm whether outbound traffic is IPv6.
If confirmed, the instruction is to disable IPv6 immediately.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-29 16:17:06 +08:00
gumponchain c2799c73d1 docs: add 7 workflow docs and update skill/readme cross-references
New workflow docs:
- workflow-token-research.md — pre-buy token due diligence
- workflow-wallet-analysis.md — wallet quality assessment
- workflow-smart-money-profile.md — trading style analysis and copy-trade ROI estimate
- workflow-risk-warning.md — active risk monitoring (whale exit, liquidity, dev dump)
- workflow-early-project-screening.md — new launchpad token screening
- workflow-daily-brief.md — daily market overview
- workflow-project-deep-report.md — comprehensive token analysis with scored dimensions

Renamed docs for consistent workflow- prefix naming:
- market-discover-opportunities.md → workflow-market-opportunities.md
- token-due-diligence.md → workflow-token-due-diligence.md

Updated SKILL.md files (portfolio, track, token, market, swap) with workflow
cross-reference links at relevant trigger points. Updated CLAUDE.md quick
decision table and workflow docs index. Added Workflow Docs section to
Readme.md and Readme.zh.md.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-29 01:15:22 +08:00
gumponchain fe80a8aba7 docs: add Core Concepts, AI Agent install guide, and workflow docs
- README: add Quick Start (AI Agent) section with step-by-step key generation
  and .env configuration guidance; add Upgrade (AI Agent) section
- README.zh.md: sync all changes from English README
- skills/gmgn-market: add Core Concepts (10 terms: volume/amount distinction,
  rug_ratio, smart_degen_count, hot_level, renounced authorities, honeypot,
  creator_token_status, cto_flag, trenches lifecycle, wash/rat/bundler signals);
  add "Do NOT guess fields" IMPORTANT rule
- skills/gmgn-portfolio: add Core Concepts (7 terms: realized/unrealized profit,
  profit_change multiplier, pnl ratio, winrate, cost vs usd_value, pagination);
  complete Response Field Reference tables for holdings/activity/stats
- skills/gmgn-swap: add Core Concepts (8 terms: smallest unit, slippage decimal,
  amount vs percent mutex, currency tokens, anti-MEV, critical auth, order polling,
  filled amount conversion); add "Do NOT guess fields" IMPORTANT rule
- skills/gmgn-track: add Core Concepts (8 terms: follow-wallet vs kol vs
  smartmoney, KOL vs smart_degen, is_open_or_close divergence, price_change ratio,
  base/quote address, tags array, cluster signal); add Safety Constraints section;
  add Output Format section; add "Do NOT guess fields" IMPORTANT rule
- skills/gmgn-token: add --amount/--percent and --slippage/--auto-slippage mutex
  rules; add --tag + --order-by valid combination guide table for traders
- src/index.ts: add track to CLI description
- docs/token-due-diligence.md: new — full 4-step token due diligence workflow
- docs/market-discover-opportunities.md: new — market discovery workflow

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-28 23:11:13 +08:00
gumponchain 174a87c117 docs: expand token holders/traders response field reference
Replace the 10-line placeholder with a complete field reference based
on actual API output, grouped into Identity & Holdings, Trading Summary,
Cost & P&L, Transfer History, Timing, Wallet Identity, and Last
Transaction Records sections.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-28 23:11:13 +08:00
David Lau b7302f5253 fix: move wallet_holdings filter defaults to CLI, remove no-op flags
Portfolio holdings to return empty results for wallets that only have closed positions (issue #21).

Changes:
- Convert --hide-closed, --hide-airdrop, --hide-abnormal to value options with explicit defaults (hide_closed=true, hide_airdrop=true, hide_abnormal=false), so defaults are enforced by the CLI and users can override with e.g. --hide-closed false
- Remove --sell-out and --show-small which are hard-coded in the service and were never forwarded to the upstream API
- Update SKILL.md to reflect new option signatures and defaults

Fixes #21

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-27 18:48:47 +08:00
gumponchain 59d7c71e75 1.1.6 v1.1.6 2026-03-27 17:47:20 +08:00
David Lau 87540d6327 fix: remove default tag filter from token holders and traders commands
- Remove hardcoded "renowned" default from --tag in `token holders` command
- Remove hardcoded "renowned" default from --tag in `token traders` command
- Update skills/gmgn-token/SKILL.md to show --tag has no default (returns all wallets when omitted)

Fixes #14
2026-03-27 17:25:09 +08:00
gumponchain a5ff97881c docs: add IPv6 warning, follow-wallet response fields, update README quick start
- Add IPv6 not supported warning to all 5 SKILL.md headers
- Add complete track follow-wallet response field reference
- Fix --tag default to empty in gmgn-token SKILL.md
- Add "Update Skills and CLI" jump link in README Quick Start

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-27 17:20:41 +08:00
gumponchain 9c2a349ecf docs: add IPv6 warning to all skills and follow-wallet response fields
- Add IPv6 not supported warning to all 5 SKILL.md headers
- Add detailed `track follow-wallet` response field reference based on actual API output
- Fix `--tag` default value to empty in gmgn-token SKILL.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-27 17:20:41 +08:00
gumponchain fa2afae426 1.1.5 v1.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 v1.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
dev d9d1bf8200 initial import 2026-03-16 18:40:55 +08:00