1.3.0

1.2.10
Merge pull request #122 from GumpOnchain/docs/token-native-transfer-shared-funding
2026-07-28 01:07:44 +00:00 · 2026-05-14 20:47:03 +08:00 · 2026-05-14 20:46:10 +08:00 · 2026-05-14 20:44:38 +08:00 · 2026-05-14 20:43:36 +08:00 · 2026-05-14 20:08:22 +08:00
19 changed files with 226 additions and 118 deletions
@@ -20,7 +20,7 @@ This includes: trending tokens, token info, security checks, K-line / price hist

 ## 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.
+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 / eth.

 ## Available Skills

@@ -93,8 +93,8 @@ EOF

 | Mode | Commands | Requirements |
 |------|----------|--------------|
-| Normal | token / market / portfolio | `GMGN_API_KEY` only, no signature |
-| Critical | swap / order | `GMGN_API_KEY` + `GMGN_PRIVATE_KEY` — CLI handles signing automatically |
+| Normal | token / market / portfolio / track kol / track smartmoney | `GMGN_API_KEY` only, no signature |
+| Critical | swap / order / track follow-wallet | `GMGN_API_KEY` + `GMGN_PRIVATE_KEY` — CLI handles signing automatically |

 ## SKILL.md Authoring Rules

@@ -22,7 +22,7 @@ With GMGN Agent Skills, you can use AI agents to query real-time trending token

 ### 1. Real-time on-chain data — faster

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

 | Data | Granularity |
 |------|-------------|
@@ -579,7 +579,7 @@ gmgn-cli multi-swap \
  --slippage 0.01
 ```

-> `order quote` uses critical auth on `sol` / `bsc` / `base` and requires `GMGN_PRIVATE_KEY`.
+> `order quote` uses critical auth on `sol` / `bsc` / `base` / `eth` and requires `GMGN_PRIVATE_KEY`.

 ### Swap with Take-Profit / Stop-Loss Orders (requires private key)

@@ -672,8 +672,8 @@ gmgn-cli cooking \

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

 ---

@@ -22,7 +22,7 @@

 ### 1. 链上实时数据查询快

-SOL / BSC / Base 多链数据每次查询均为实时，支持多参数个性化调用，无快照缓存，方便AI Agent实时决策（包括不限于下表）。
+SOL / BSC / Base / ETH 多链数据每次查询均为实时，支持多参数个性化调用，无快照缓存，方便AI Agent实时决策（包括不限于下表）。

 | 数据类型 | 粒度 |
 |---------|------|
@@ -603,7 +603,7 @@ gmgn-cli multi-swap \
  --slippage 0.01
 ```

-> `order quote` 在 `sol` / `bsc` / `base` 上都走关键鉴权，必须配置 `GMGN_PRIVATE_KEY`。
+> `order quote` 在 `sol` / `bsc` / `base` / `eth` 上都走关键鉴权，必须配置 `GMGN_PRIVATE_KEY`。

 ### 带止盈止损的 Swap（需要私钥）

@@ -696,8 +696,8 @@ gmgn-cli cooking \

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

 ---

@@ -1,12 +1,12 @@
 {
  "name": "gmgn-cli",
-  "version": "1.2.5",
+  "version": "1.3.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "gmgn-cli",
-      "version": "1.2.5",
+      "version": "1.3.0",
      "license": "MIT",
      "dependencies": {
        "commander": "^12.1.0",
@@ -1,6 +1,6 @@
 {
  "name": "gmgn-cli",
-  "version": "1.2.5",
+  "version": "1.3.0",
  "description": "GMGN OpenAPI CLI — call GMGN market, token, portfolio and swap APIs from the command line",
  "type": "module",
  "bin": {
@@ -74,7 +74,7 @@ If a local `.env` exists but lacks `GMGN_API_KEY` / `GMGN_PRIVATE_KEY`, either a

 ## Rate Limit Handling

-All cooking routes go through GMGN's leaky-bucket limiter with `rate=10` and `capacity=10`. Sustained throughput is roughly `10 ÷ weight` requests/second.
+All cooking routes go through GMGN's leaky-bucket limiter with `rate=20` and `capacity=20`. Sustained throughput is roughly `20 ÷ weight` requests/second.

 | Command | Weight |
 |---------|--------|
@@ -1,7 +1,7 @@
 ---
 name: gmgn-market
-description: Get crypto and meme token price charts (K-line, candlestick, OHLCV), trending meme coin rankings by volume, and newly launched tokens on launchpads (pump.fun, fourmeme, letsbonk, Raydium, etc.) via GMGN API on Solana, BSC, or Base. Use when user asks for price chart, trending tokens, what's pumping, hot coins, new launches, token signals, or wants to discover early-stage opportunities.
-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> | signal --chain <sol|bsc>""
+description: Get crypto and meme token price charts (K-line, candlestick, OHLCV), trending meme coin rankings by volume, and newly launched tokens on launchpads (pump.fun, fourmeme, letsbonk, Raydium, etc.) via GMGN API on Solana, BSC, Base, or Ethereum. Use when user asks for price chart, trending tokens, what's pumping, hot coins, new launches, token signals, or wants to discover early-stage opportunities.
+argument-hint: "kline --chain <sol|bsc|base|eth> --address <token_address> --resolution <1m|5m|15m|1h|4h|1d> [--from <unix_ts>] [--to <unix_ts>] | trending --chain <sol|bsc|base|eth> --interval <1m|5m|1h|6h|24h> | trenches --chain <sol|bsc|base> | signal --chain <sol|bsc>"
 metadata:
  cliHelp: "gmgn-cli market --help"
 ---
@@ -18,7 +18,7 @@ Use the `gmgn-cli` tool to query K-line data for a token, browse trending tokens

 - **`--filter` chain defaults** — SOL and EVM chains have different default safety filters that are applied automatically when `--filter` is omitted. Do not assume the same defaults apply across chains:
  - **SOL**: defaults to `renounced frozen` (mint and freeze authority renounced)
-  - **BSC / Base (EVM)**: defaults to `not_honeypot verified renounced`
+  - **BSC / Base / ETH (EVM)**: defaults to `not_honeypot verified renounced`
  - Omitting `--filter` is NOT the same as "no filter" — the chain defaults are always applied. To use a custom filter set, explicitly specify all desired filter tags.

 - **`volume` vs `amount` (kline)** — Naming is counterintuitive. `volume` = USD dollar value of trades; `amount` = token units traded. For a token priced at $0.0002, these differ by 5,000×. Always use `volume` for "how much USD was traded" and `amount` for "how many tokens changed hands."
@@ -52,7 +52,7 @@ Use the `gmgn-cli` tool to query K-line data for a token, browse trending tokens

 ## Supported Chains

-`sol` / `bsc` / `base` (signal: `sol` / `bsc` only)
+`sol` / `bsc` / `base` / `eth` (kline / trending only; trenches: `sol` / `bsc` / `base`; signal: `sol` / `bsc` only)

 ## Prerequisites

@@ -61,7 +61,7 @@ Use the `gmgn-cli` tool to query K-line data for a token, browse trending tokens

 ## Rate Limit Handling

-All market routes used by this skill go through GMGN's leaky-bucket limiter with `rate=10` and `capacity=10`. Sustained throughput is roughly `10 ÷ weight` requests/second, and the max burst is roughly `floor(10 ÷ weight)` when the bucket is full.
+All market routes used by this skill go through GMGN's leaky-bucket limiter with `rate=20` and `capacity=20`. Sustained throughput is roughly `20 ÷ weight` requests/second, and the max burst is roughly `floor(20 ÷ weight)` when the bucket is full.

 | Command | Route | Weight |
 |---------|-------|--------|
@@ -97,7 +97,7 @@ When a request returns `429`:

 | Parameter | Required | Description |
 |-----------|----------|-------------|
-| `--chain` | Yes | `sol` / `bsc` / `base` |
+| `--chain` | Yes | `sol` / `bsc` / `base` / `eth` |
 | `--address` | Yes | Token contract address |
 | `--resolution` | Yes | Candlestick resolution: `1m` / `5m` / `15m` / `1h` / `4h` / `1d` |
 | `--from` | No | Start time (Unix seconds) |
@@ -140,13 +140,13 @@ The response is an object with a `list` array. Each element in `list` is one can

 | Option | Description |
 |--------|-------------|
-| `--chain` | Required. `sol` / `bsc` / `base` |
+| `--chain` | Required. `sol` / `bsc` / `base` / `eth` |
 | `--interval` | Required. `1m` / `5m` / `1h` / `6h` / `24h` (default `1h`) |
 | `--limit <n>` | Number of results (default 100, max 100) |
 | `--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 (chain-specific). **⚠️ SOL defaults: `renounced frozen`; BSC/Base defaults: `not_honeypot verified renounced`.** Omitting `--filter` is NOT "no filter" — chain defaults always apply. **sol** tags: `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** tags: `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` |
+| `--filter <tag...>` | Repeatable filter tags (chain-specific). **⚠️ SOL defaults: `renounced frozen`; BSC/Base/ETH defaults: `not_honeypot verified renounced`.** Omitting `--filter` is NOT "no filter" — chain defaults always apply. **sol** tags: `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** tags: `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`. **eth**: no platform filter (omit `--platform` for ETH) |

 ## Usage Examples

@@ -176,6 +176,14 @@ gmgn-cli market kline \
 # Raw output for further processing
 gmgn-cli market kline --chain sol --address <addr> \
  --resolution 5m --from <ts> --to <ts> --raw | jq '.[]'
+
+# ETH token kline — last 24h, 1h candles (macOS)
+gmgn-cli market kline \
+  --chain eth \
+  --address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 \
+  --resolution 1h \
+  --from $(date -v-24H +%s) \
+  --to $(date +%s)
 ```

 ### Trending — General
@@ -248,6 +256,25 @@ gmgn-cli market trending \
  --order-by volume --limit 20 --raw
 ```

+### Trending — ETH (No Platform Filter)
+
+```bash
+# ETH 1h trending — all tokens, sorted by volume
+gmgn-cli market trending --chain eth --interval 1h --order-by volume --limit 20
+
+# ETH 1h trending — with safety filters
+gmgn-cli market trending \
+  --chain eth --interval 1h \
+  --filter not_honeypot --filter verified \
+  --order-by volume --limit 20 --raw
+
+# ETH 24h trending — sorted by smart money count
+gmgn-cli market trending \
+  --chain eth --interval 24h \
+  --filter not_honeypot --filter verified \
+  --order-by smart_degen_count --limit 20 --raw
+```
+
 ### Trending — Base by Launchpad Platform

 ```bash
@@ -507,7 +534,7 @@ All filter flags are sent as part of the API request body — the server filters
 | `--min-progress` / `--max-progress` | float | Bonding curve progress (0–1) |
 | `--min-marketcap` / `--max-marketcap` | float | Market cap (USD) |
 | `--min-liquidity` / `--max-liquidity` | float | Liquidity (USD) |
-| `--min-created` / `--max-created` | string | Token age (e.g. `1m` / `5m` / `1h` / `24h`) |
+| `--min-created` / `--max-created` | duration | Token age — unit suffix recommended: seconds (`30s`, `10s`) or minutes (`0.5m`, `1m`, `5m`, `30m`). Bare numbers (e.g. `5`) are treated as minutes with a warning. |
 | `--min-holder-count` / `--max-holder-count` | int | Holder count |
 | `--min-top-holder-rate` / `--max-top-holder-rate` | float | Top-10 holder concentration (0–1) |
 | `--min-rug-ratio` / `--max-rug-ratio` | float | Rug pull risk score (0–1) |
@@ -817,6 +844,8 @@ Chains: `sol` / `bsc` only. **Maximum 50 results per group** — use multiple gr

 **Single-group (individual flags):**

+Do **not** pass signal types **14, 15, or 16** in `signal_type` / `--signal-type` / `--groups` JSON — OpenAPI returns **400** if any group includes them. Omitting `--signal-type` (empty filter) still queries all types upstream; responses may still include 14–16 in that case.
+
 | Option | Required | Description |
 |--------|----------|-------------|
 | `--chain` | Yes | `sol` / `bsc` |
@@ -836,7 +865,7 @@ Pass `--groups '<json_array>'` to query multiple filter groups in a single reque

 ```bash
 gmgn-cli market signal --chain sol \
-  --groups '[{"signal_type":[12,14]},{"signal_type":[6,7],"mc_min":50000}]'
+  --groups '[{"signal_type":[12,13]},{"signal_type":[6,7],"mc_min":50000}]'
 ```

 ### Signal Types
@@ -892,7 +921,7 @@ Each item in the response array is one signal event:
 ### Usage Examples

 ```bash
-# All signals on SOL (default: all types)
+# All signals on SOL (no --signal-type: upstream returns all types, including 14–16 if present)
 gmgn-cli market signal --chain sol --raw

 # Smart money buys only (type 12)
@@ -906,13 +935,13 @@ gmgn-cli market signal --chain sol \
 # Smart money buys on BSC
 gmgn-cli market signal --chain bsc --signal-type 12 --raw

-# Multi-group: smart money buys OR large amount buys, in parallel
+# Multi-group: parallel groups (do not use signal_type 14–16 — API returns 400)
 gmgn-cli market signal --chain sol \
-  --groups '[{"signal_type":[12]},{"signal_type":[14,16]}]' --raw
+  --groups '[{"signal_type":[12]},{"signal_type":[6,7]}]' --raw

 # Multi-group: combine signal type filter with market cap range per group
 gmgn-cli market signal --chain sol \
-  --groups '[{"signal_type":[12,14],"mc_min":100000},{"signal_type":[6,7],"mc_min":50000,"mc_max":1000000}]' --raw
+  --groups '[{"signal_type":[12,13],"mc_min":100000},{"signal_type":[6,7],"mc_min":50000,"mc_max":1000000}]' --raw
 ```

 ---
@@ -1,7 +1,7 @@
 ---
 name: gmgn-portfolio
-description: Analyze any crypto wallet by address — holdings, realized/unrealized P&L, win rate, trading history, performance stats, specific token balance, and tokens created by a developer wallet (with ATH market cap and DEX graduation status) via GMGN API on Solana, BSC, or Base. Use when user asks about a wallet's holdings, P&L, win rate, what tokens a dev has launched, the highest ATH token a dev ever created, or wants a wallet report to decide whether to copy-trade or follow.
-argument-hint: "<info|holdings|activity|stats|token-balance|created-tokens> [--chain <sol|bsc|base>] [--wallet <wallet_address>]"
+description: Analyze any crypto wallet by address — holdings, realized/unrealized P&L, win rate, trading history, performance stats, specific token balance, and tokens created by a developer wallet (with ATH market cap and DEX graduation status) via GMGN API on Solana, BSC, Base, or Ethereum. Use when user asks about a wallet's holdings, P&L, win rate, what tokens a dev has launched, the highest ATH token a dev ever created, or wants a wallet report to decide whether to copy-trade or follow.
+argument-hint: "<info|holdings|activity|stats|token-balance|created-tokens> [--chain <sol|bsc|base|eth>] [--wallet <wallet_address>]"
 metadata:
  cliHelp: "gmgn-cli portfolio --help"
 ---
@@ -43,7 +43,7 @@ Use the `gmgn-cli` tool to query wallet portfolio data based on the user's reque

 ## Supported Chains

-`sol` / `bsc` / `base`
+`sol` / `bsc` / `base` / `eth`

 ## Prerequisites

@@ -52,7 +52,7 @@ Use the `gmgn-cli` tool to query wallet portfolio data based on the user's reque

 ## Rate Limit Handling

-All portfolio routes used by this skill go through GMGN's leaky-bucket limiter with `rate=10` and `capacity=10`. Sustained throughput is roughly `10 ÷ weight` requests/second, and the max burst is roughly `floor(10 ÷ weight)` when the bucket is full.
+All portfolio routes used by this skill go through GMGN's leaky-bucket limiter with `rate=20` and `capacity=20`. Sustained throughput is roughly `20 ÷ weight` requests/second, and the max burst is roughly `floor(20 ÷ weight)` when the bucket is full.

 | Command | Route | Weight |
 |---------|-------|--------|
@@ -139,6 +139,16 @@ gmgn-cli portfolio created-tokens \
 # Only migrated tokens
 gmgn-cli portfolio created-tokens \
  --chain sol --wallet <wallet_address> --migrate-state migrated
+
+# ETH wallet holdings
+gmgn-cli portfolio holdings --chain eth --wallet <0x_wallet_address>
+
+# ETH wallet transaction activity
+gmgn-cli portfolio activity --chain eth --wallet <0x_wallet_address>
+
+# ETH token balance
+gmgn-cli portfolio token-balance \
+  --chain eth --wallet <0x_wallet_address> --token <0x_token_address>
 ```

 ## `portfolio created-tokens` Options
@@ -1,6 +1,6 @@
 ---
 name: gmgn-swap
-description: "[FINANCIAL EXECUTION] Buy and sell meme coins and crypto tokens on Solana, BSC, or Base — single swap, multi-wallet batch trading, limit orders, stop loss, take profit, trailing stop loss, trailing take profit via GMGN API. Requires explicit user confirmation. Use when user asks to buy, sell, or swap a token, trade from multiple wallets, set a limit order, stop loss, take profit, or check order status."
+description: "[FINANCIAL EXECUTION] Buy and sell meme coins and crypto tokens on Solana, BSC, Base, or Ethereum — single swap, multi-wallet batch trading, limit orders, stop loss, take profit, trailing stop loss, trailing take profit via GMGN API. Requires explicit user confirmation. Use when user asks to buy, sell, or swap a token, trade from multiple wallets, set a limit order, stop loss, take profit, or check order status."
 argument-hint: "[--chain <chain> --from <wallet> --input-token <addr> --output-token <addr> --amount <n>] | [order get --chain <chain> --order-id <id>] | [order strategy list --chain <chain> --group-tag <LimitOrder|STMix>] | [order strategy create --chain <chain> --order-type limit_order --sub-order-type <buy_low|buy_high|stop_loss|take_profit> ...]"
 metadata:
  cliHelp: "gmgn-cli swap --help"
@@ -55,18 +55,20 @@ Use the `gmgn-cli` tool to submit a token swap or query an existing order. `GMGN

 ## Supported Chains

-`sol` / `bsc` / `base` 
-
+`sol` / `bsc` / `base` / `eth`

 ## Chain Currencies

 Currency tokens are the base/native assets of each chain. They are used to buy other tokens or receive proceeds from selling. Knowing which tokens are currencies is critical for `--percent` usage (see Swap Parameters below).

-| Chain | Currency tokens |
-|-------|----------------|
-| `sol` | SOL (native, So11111111111111111111111111111111111111112), USDC (`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`) |
-| `bsc` | BNB (native, 0x0000000000000000000000000000000000000000), USDC (`0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d`) |
-| `base` | ETH (native, 0x0000000000000000000000000000000000000000), USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`) |
+> ⚠️ **CRITICAL: Always copy currency addresses from this table — NEVER rely on memory or training data.** A wrong address (e.g. `So11111111111111111111111111111111111111111` instead of `So11111111111111111111111111111111111111112`) will cause silent failures or `jupiter has no route` errors with no clear indication of what went wrong.
+
+| Chain  | Currency tokens |
+| ------ | --------------- |
+| `sol`  | SOL (native, `So11111111111111111111111111111111111111112`), USDC (`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`) |
+| `bsc`  | BNB (native, `0x0000000000000000000000000000000000000000`), USDC (`0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d`) |
+| `base` | ETH (native, `0x0000000000000000000000000000000000000000`), USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`) |
+| `eth`  | ETH (native, `0x0000000000000000000000000000000000000000`) |


 ## Prerequisites
@@ -77,7 +79,7 @@ Currency tokens are the base/native assets of each chain. They are used to buy o

 ## Rate Limit Handling

-All swap-related routes used by this skill go through GMGN's leaky-bucket limiter with `rate=10` and `capacity=10`. Sustained throughput is roughly `10 ÷ weight` requests/second, and the max burst is roughly `floor(10 ÷ weight)` when the bucket is full.
+All swap-related routes used by this skill go through GMGN's leaky-bucket limiter with `rate=20` and `capacity=20`. Sustained throughput is roughly `20 ÷ weight` requests/second, and the max burst is roughly `floor(20 ÷ weight)` when the bucket is full.

 | Command | Route | Weight |
 |---------|-------|--------|
@@ -199,13 +201,23 @@ gmgn-cli multi-swap \
  --priority-fee 0.00001 \
  --tip-fee 0.00001 \
  --condition-orders '[{"order_type":"profit_stop","side":"sell","price_scale":"100","sell_ratio":"100"},{"order_type":"loss_stop","side":"sell","price_scale":"50","sell_ratio":"100"}]'
+
+# ETH multi-wallet swap (EIP-1559 gas)
+gmgn-cli multi-swap \
+  --chain eth \
+  --accounts <0xaddr1>,<0xaddr2> \
+  --input-token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
+  --output-token <token_address> \
+  --input-amount '{"<0xaddr1>":"1000000","<0xaddr2>":"2000000"}' \
+  --slippage 0.01 \
+  --gas-price 5
 ```

 ## `multi-swap` Parameters

 | Parameter | Required | Description |
 |-----------|----------|-------------|
-| `--chain` | Yes | `sol` / `bsc` / `base` |
+| `--chain` | Yes | `sol` / `bsc` / `base` / `eth` |
 | `--accounts` | Yes | Comma-separated wallet addresses (1–100, all must be bound to the API Key) |
 | `--input-token` | Yes | Input token contract address |
 | `--output-token` | Yes | Output token contract address |
@@ -219,9 +231,9 @@ gmgn-cli multi-swap \
 | `--tip-fee <amount>` | No | Tip fee (SOL ≥ 0.00001 / BSC ≥ 0.000001 BNB). Required when using `--condition-orders` on SOL. |
 | `--auto-tip-fee` | No | Enable automatic tip fee. |
 | `--max-auto-fee <amount>` | No | Max automatic fee cap. |
-| `--gas-price <gwei>` | No | Gas price in gwei (BSC ≥ 0.05 / BASE/ETH ≥ 0.01). Required when using `--condition-orders` on BSC. |
-| `--max-fee-per-gas <amount>` | No | EIP-1559 max fee per gas (Base only). |
-| `--max-priority-fee-per-gas <amount>` | No | EIP-1559 max priority fee per gas (Base only). |
+| `--gas-price <gwei>` | No | Gas price in gwei (BSC: 0.05–10 / BASE: 0.01–10 / ETH: 2–20). Required when using `--condition-orders` on BSC. |
+| `--max-fee-per-gas <amount>` | No | EIP-1559 max fee per gas (Base / ETH). Defaults to `--gas-price` if omitted. |
+| `--max-priority-fee-per-gas <amount>` | No | EIP-1559 max priority fee per gas (Base / ETH). Defaults to `--gas-price` if omitted. |
 | `--condition-orders <json>` | No | JSON array of condition sub-orders (take-profit / stop-loss) attached to each successful wallet's swap. Same structure as `swap --condition-orders`. Strategy creation is best-effort per wallet. |
 | `--sell-ratio-type <type>` | No | Sell ratio base for `--condition-orders`: `buy_amount` (default) / `hold_amount`. |

@@ -273,7 +285,7 @@ gmgn-cli order get --chain sol --order-id <order_id>

 | Parameter | Required | Description |
 |-----------|----------|-------------|
-| `--chain` | Yes | `sol` / `bsc` / `base` |
+| `--chain` | Yes | `sol` / `bsc` / `base` / `eth` |
 | `--from` | Yes | Wallet address (must match API Key binding) |
 | `--input-token` | Yes | Input token contract address |
 | `--output-token` | Yes | Output token contract address |
@@ -442,7 +454,7 @@ Convert `report.input_amount` and `report.output_amount` from smallest unit usin

 | Parameter | Required | Description |
 |-----------|----------|-------------|
-| `--chain` | Yes | `sol` / `bsc` / `base` |
+| `--chain` | Yes | `sol` / `bsc` / `base` / `eth` |
 | `--from` | Yes | Wallet address (must match API Key binding) |
 | `--base-token` | Yes | Base token contract address |
 | `--quote-token` | Yes | Quote token contract address |
@@ -473,7 +485,7 @@ Convert `report.input_amount` and `report.output_amount` from smallest unit usin

 | Parameter | Required | Description |
 |-----------|----------|-------------|
-| `--chain` | Yes | `sol` / `bsc` / `base` |
+| `--chain` | Yes | `sol` / `bsc` / `base` / `eth` |
 | `--type` | No | `open` (default) / `history` |
 | `--from` | No | Filter by wallet address |
 | `--group-tag` | Yes | Filter by order group: `LimitOrder` (limit orders only) / `STMix` (mixed strategy orders: take-profit, stop-loss, trailing take-profit, trailing stop-loss) |
@@ -493,7 +505,7 @@ Convert `report.input_amount` and `report.output_amount` from smallest unit usin

 | Parameter | Required | Description |
 |-----------|----------|-------------|
-| `--chain` | Yes | `sol` / `bsc` / `base` |
+| `--chain` | Yes | `sol` / `bsc` / `base` / `eth` |
 | `--from` | Yes | Wallet address (must match API Key binding) |
 | `--order-id` | Yes | Order ID to cancel |
 | `--order-type` | No | Order type: `limit_order` (limit order) / `smart_trade` (mixed strategy order: take-profit, stop-loss, trailing take-profit, trailing stop-loss) |
@@ -1,7 +1,7 @@
 ---
 name: gmgn-token
-description: Research any crypto or meme token by address — real-time price, market cap, liquidity, holder list, trader list, top Smart Money and KOL positions, security audit (honeypot, rug pull risk, dev wallet, renounced status), social links (Twitter/X, website) via GMGN API on Solana, BSC, or Base. Use when user asks about a token's price, safety, holders, traders, smart money exposure, or wants due diligence before buying.
-argument-hint: "<sub-command> --chain <sol|bsc|base> --address <token_address>"
+description: Research any crypto or meme token by address — real-time price, market cap, liquidity, holder list, trader list, top Smart Money and KOL positions, security audit (honeypot, rug pull risk, dev wallet, renounced status), social links (Twitter/X, website) via GMGN API on Solana, BSC, Base, or Ethereum. Use when user asks about a token's price, safety, holders, traders, smart money exposure, or wants due diligence before buying.
+argument-hint: "<sub-command> --chain <sol|bsc|base|eth> --address <token_address>"
 metadata:
  cliHelp: "gmgn-cli token --help"
 ---
@@ -17,7 +17,7 @@ Use the `gmgn-cli` tool to query token information based on the user's request.
 ## Core Concepts

 - **Token address** — The on-chain contract address that uniquely identifies a token on its chain. Required for all token sub-commands. Format: base58 (SOL) or `0x...` hex (BSC/Base).
- **Chain** — The blockchain network: `sol` = Solana, `bsc` = BNB Smart Chain, `base` = Base (Coinbase L2).
+- **Chain** — The blockchain network: `sol` = Solana, `bsc` = BNB Smart Chain, `base` = Base (Coinbase L2), `eth` = Ethereum mainnet.
 - **Market cap** — Not returned directly by `token info`. Calculate as `price × circulating_supply` (both are top-level fields in the response, already in human-readable units).
 - **Liquidity** — USD value of token reserves in the main trading pool. Low liquidity (< $10k) means high price impact / slippage when buying or selling.
 - **Holder** — A wallet that currently holds the token. `token holders` returns wallets ranked by current balance.
@@ -42,7 +42,7 @@ Use the `gmgn-cli` tool to query token information based on the user's request.

 ## Supported Chains

-`sol` / `bsc` / `base`
+`sol` / `bsc` / `base` / `eth`

 ## Prerequisites

@@ -51,7 +51,7 @@ Use the `gmgn-cli` tool to query token information based on the user's request.

 ## Rate Limit Handling

-All token routes used by this skill go through GMGN's leaky-bucket limiter with `rate=10` and `capacity=10`. Sustained throughput is roughly `10 ÷ weight` requests/second, and the max burst is roughly `floor(10 ÷ weight)` when the bucket is full.
+All token routes used by this skill go through GMGN's leaky-bucket limiter with `rate=20` and `capacity=20`. Sustained throughput is roughly `20 ÷ weight` requests/second, and the max burst is roughly `floor(20 ÷ weight)` when the bucket is full.

 | Command | Route | Weight |
 |---------|-------|--------|
@@ -88,7 +88,7 @@ When a request returns `429`:

 | Parameter | Required | Description |
 |-----------|----------|-------------|
-| `--chain` | Yes | `sol` / `bsc` / `base` |
+| `--chain` | Yes | `sol` / `bsc` / `base` / `eth` |
 | `--address` | Yes | Token contract address |
 | `--raw` | No | Output raw single-line JSON (for piping or further processing) |

@@ -96,12 +96,12 @@ When a request returns `429`:

 | Parameter | Required | Default | Description |
 |-----------|----------|---------|-------------|
-| `--chain` | Yes | — | `sol` / `bsc` / `base` |
+| `--chain` | Yes | — | `sol` / `bsc` / `base` / `eth` |
 | `--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 | — | Wallet filter: `renowned` (KOL wallets) / `smart_degen` (smart money). Omit to return all wallets. |
+| `--tag` | No | — | Wallet filter: `smart_degen` / `renowned` / `fresh_wallet` / `dev` / `sniper` / `rat_trader` / `bundler` / `transfer_in` / `dex_bot` / `bluechip_owner`. Omit to return all wallets. |
 | `--raw` | No | — | Output raw single-line JSON |

 ### `--order-by` Values
@@ -116,10 +116,18 @@ When a request returns `429`:

 ### `--tag` Values

-| Value | Description |
-|-------|-------------|
-| `renowned` | KOL / well-known wallets (influencers, funds, public figures) |
-| `smart_degen` | Smart money wallets (historically high-performing traders) |
+| Value          | Description |
+| -------------- | ----------- |
+| `smart_degen`  | Smart money wallets (historically high-performing traders) |
+| `renowned`     | KOL / well-known wallets (influencers, funds, public figures) |
+| `fresh_wallet` | New wallets with no prior trading history |
+| `dev`          | Token developer / creator wallets |
+| `sniper`       | Wallets that sniped the token at launch |
+| `rat_trader`   | Insider / sneak-trading wallets |
+| `bundler`      | Bot-bundled buy wallets |
+| `transfer_in`  | Wallets with a transfer-in record for this token |
+| `dex_bot`      | DEX bot wallets (Axiom, Photon, BullX, Trojan, GMGN, Drops, PepeBoost, Padre) |
+| `bluechip_owner` | Wallets holding established bluechip tokens |

 ### `--tag` + `--order-by` Combination Guide

@@ -241,8 +249,6 @@ The response has five nested objects: `pool`, `dev`, `link`, `stat`, `wallet_tag
 | 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 |
@@ -412,13 +418,18 @@ The response is an object with a `list` array. Each item in `list` represents on
 | `maker_token_tags` | Token-specific behavior tags for this wallet (e.g. `["bundler"]`, `["paper_hands"]`, `["top_holder"]`) |
 | `created_at` | Wallet creation timestamp (Unix seconds); `0` if unknown |

+**Shared Funding**
+
+| Field | Description |
+|-------|-------------|
+| `native_transfer` | First native token (SOL/BNB/ETH) transfer into this wallet — indicates the original funding source; wallets sharing the same `native_transfer.address` are likely funded from a common origin (coordinated wallets / same operator) |
+
 **Last Transaction Records**

 Each of the following is an object with `name`, `address`, `timestamp`, `tx_hash`, `type`:

 | Field | Description |
 |-------|-------------|
-| `native_transfer` | Most recent native token (SOL/BNB/ETH) transfer associated with this wallet |
 | `token_transfer` | Most recent token transfer (buy or sell) |
 | `token_transfer_in` | Most recent inbound token transfer |
 | `token_transfer_out` | Most recent outbound token transfer |
@@ -439,6 +450,9 @@ gmgn-cli token info --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD959F9
 # Get basic info for a Base token
 gmgn-cli token info --chain base --address 0x4200000000000000000000000000000000000006

+# Get basic info for an ETH token
+gmgn-cli token info --chain eth --address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2
+
 # Raw JSON output for downstream processing
 gmgn-cli token info --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --raw
 ```
@@ -455,6 +469,9 @@ gmgn-cli token security --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD9
 # Check a Base token for tax, rug ratio, and insider concentration
 gmgn-cli token security --chain base --address 0x4200000000000000000000000000000000000006

+# Check an ETH token for honeypot and contract risks
+gmgn-cli token security --chain eth --address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2
+
 # Raw output for parsing key fields (e.g. is_honeypot, buy_tax, rug_ratio)
 gmgn-cli token security --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD959F933F8 --raw
 ```
@@ -467,6 +484,9 @@ gmgn-cli token pool --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZw

 # Get pool info for a BSC token
 gmgn-cli token pool --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD959F933F8
+
+# Get pool info for an ETH token
+gmgn-cli token pool --chain eth --address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2
 ```

 ### `token holders` — Analyze Holder Distribution
@@ -503,6 +523,10 @@ gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGG
 gmgn-cli token holders --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD959F933F8 \
  --tag renowned --order-by profit --direction desc --limit 50

+# ETH token holders — smart money by supply percentage
+gmgn-cli token holders --chain eth --address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 \
+  --tag smart_degen --order-by amount_percentage --direction desc --limit 20
+
 # Raw output for downstream analysis
 gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --limit 100 --raw
@@ -551,6 +575,10 @@ gmgn-cli token traders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGG
 # BSC token traders by profit
 gmgn-cli token traders --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD959F933F8 \
  --tag smart_degen --order-by profit --direction desc --limit 50
+
+# ETH token traders by profit
+gmgn-cli token traders --chain eth --address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 \
+  --tag smart_degen --order-by profit --direction desc --limit 50
 ```

 ---
@@ -1,7 +1,7 @@
 ---
 name: gmgn-track
-description: Get real-time crypto buy/sell activity from Smart Money wallets, KOL influencer wallets, and personally followed wallets via GMGN API — alpha signals, whale tracking, meme token copy-trading ideas on Solana, BSC, or Base. Use when user asks what smart money or KOLs are buying, wants whale alerts, on-chain alpha, or copy-trade signals. (For a specific wallet address, use gmgn-portfolio.)
-argument-hint: "<follow-wallet|kol|smartmoney> [--chain <sol|bsc|base>] [--wallet <wallet_address>]"
+description: Get real-time crypto buy/sell activity from Smart Money wallets, KOL influencer wallets, and personally followed wallets via GMGN API — alpha signals, whale tracking, meme token copy-trading ideas on Solana, BSC, Base, or Ethereum. Use when user asks what smart money or KOLs are buying, wants whale alerts, on-chain alpha, or copy-trade signals. (For a specific wallet address, use gmgn-portfolio.)
+argument-hint: "<follow-wallet|kol|smartmoney> --chain <sol|bsc|base|eth> [--wallet <wallet_address>]"
 metadata:
  cliHelp: "gmgn-cli track --help"
 ---
@@ -55,16 +55,17 @@ Use the `gmgn-cli` tool to query on-chain tracking data based on the user's requ

 ## Supported Chains

-`sol` / `bsc` / `base`
+`sol` / `bsc` / `base` / `eth`

 ## Prerequisites

 - `gmgn-cli` installed globally — if missing, run: `npm install -g gmgn-cli`
- `GMGN_API_KEY` configured in `~/.config/gmgn/.env` — required for all sub-commands; no private key needed
+- `GMGN_API_KEY` configured in `~/.config/gmgn/.env` — required for all sub-commands
+- `GMGN_PRIVATE_KEY` — required for `track follow-wallet` only (critical auth); not needed for `kol` or `smartmoney`

 ## Rate Limit Handling

-All tracking routes used by this skill go through GMGN's leaky-bucket limiter with `rate=10` and `capacity=10`. Sustained throughput is roughly `10 ÷ weight` requests/second, and the max burst is roughly `floor(10 ÷ weight)` when the bucket is full.
+All tracking routes used by this skill go through GMGN's leaky-bucket limiter with `rate=20` and `capacity=20`. Sustained throughput is roughly `20 ÷ weight` requests/second, and the max burst is roughly `floor(20 ÷ weight)` when the bucket is full.

 | Command | Route | Weight |
 |---------|-------|--------|
@@ -88,11 +89,13 @@ When a request returns `429`:
   ```
   Tell the user: *"This is your Ed25519 public key. Go to **https://gmgn.ai/ai**, paste it into the API key creation form, then send me the API Key value shown on the page."*

-2. Wait for the user's API key, then configure:
+2. Wait for the user's API key, then configure (saves both API key and private key — private key is required for `track follow-wallet`):
   ```bash
   mkdir -p ~/.config/gmgn
-   echo 'GMGN_API_KEY=<key_from_user>' > ~/.config/gmgn/.env
+   echo "GMGN_API_KEY=<key_from_user>" > ~/.config/gmgn/.env
+   echo "GMGN_PRIVATE_KEY=$(awk '{printf "%s\\n", $0}' /tmp/gmgn_private.pem)" >> ~/.config/gmgn/.env
   chmod 600 ~/.config/gmgn/.env
+   rm /tmp/gmgn_private.pem
   ```

 ## Usage Examples
@@ -127,7 +130,7 @@ gmgn-cli track smartmoney --chain sol --side sell --limit 10 --raw

 | Option | Description |
 |--------|-------------|
-| `--chain` | Required. `sol` / `bsc` / `base` |
+| `--chain` | Required. `sol` / `bsc` / `base` / `eth` |
 | `--wallet <address>` | Filter by wallet address |
 | `--limit <n>` | Page size (1–100, default 10) |
 | `--side <side>` | Trade direction: `buy` / `sell` |
@@ -139,7 +142,7 @@ gmgn-cli track smartmoney --chain sol --side sell --limit 10 --raw

 | Option | Description |
 |--------|-------------|
-| `--chain <chain>` | Chain: `sol` / `bsc` / `base` (default `sol`) |
+| `--chain <chain>` | Required. Chain: `sol` / `bsc` / `base` / `eth` |
 | `--limit <n>` | Page size (1–200, default 100) |
 | `--side <side>` | Filter by trade direction: `buy` / `sell` (client-side filter — applied locally after fetching results) |

@@ -308,7 +311,7 @@ To research any token surfaced by smart money activity, follow [`docs/workflow-t

 ## Notes

- All sub-commands use normal auth (API Key only, no signature required)
+- `track follow-wallet` uses critical auth (API Key + private key signature); `track kol` and `track smartmoney` use normal auth (API Key only)
 - `track follow-wallet` returns trades from wallets followed on the GMGN platform; the follow list is resolved automatically from the GMGN user account bound to the API Key — `--wallet` is optional
 - 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
@@ -307,7 +307,7 @@ export class OpenApiClient {
  }

  async getFollowWallet(chain: string, extra: Record<string, string | number | string[]> = {}): Promise<unknown> {
-    return this.normalRequest("GET", "/v1/trade/follow_wallet", { chain, ...extra });
+    return this.criticalRequest("GET", "/v1/trade/follow_wallet", { chain, ...extra }, null);
  }

  async getKol(chain?: string, limit?: number): Promise<unknown> {
@@ -409,16 +409,16 @@ export class OpenApiClient {
  private async criticalRequest(
    method: string,
    subPath: string,
-    queryExtra: Record<string, string | number>,
+    queryExtra: Record<string, string | number | string[]>,
    body: unknown
  ): Promise<unknown> {
    if (!this.privateKeyPem) {
-      throw new Error("GMGN_PRIVATE_KEY is required for critical-auth commands (swap and all order commands)");
+      throw new Error("GMGN_PRIVATE_KEY is required for critical-auth commands (swap, order, and follow-wallet commands)");
    }

    return this.executePreparedRequest(() => {
      const { timestamp, client_id } = buildAuthQuery();
-      const query: Record<string, string | number> = { ...queryExtra, timestamp, client_id };
+      const query: Record<string, string | number | string[]> = { ...queryExtra, timestamp, client_id };
      const bodyStr = body !== null ? JSON.stringify(body) : "";
      const message = buildMessage(subPath, query, bodyStr, timestamp);
      const signature = sign(message, this.privateKeyPem!, detectAlgorithm(this.privateKeyPem!));
@@ -32,17 +32,24 @@ export function buildAuthQuery(): { timestamp: number; client_id: string } {
 /**
 * Build the signature message (critical auth)
 * Format: {sub_path}:{sorted_query_string}:{request_body}:{timestamp}
- * sorted_query_string: all query params (including timestamp, client_id) sorted alphabetically by key
+ * sorted_query_string: all query params (including timestamp, client_id) sorted alphabetically by key.
+ * Array values are serialized as repeated k=v pairs (same as buildUrl / URLSearchParams), sorted by value.
 */
 export function buildMessage(
  subPath: string,
-  queryParams: Record<string, string | number>,
+  queryParams: Record<string, string | number | string[]>,
  body: string,
  timestamp: number
 ): string {
  const sortedQs = Object.keys(queryParams)
    .sort()
-    .map((k) => `${k}=${queryParams[k]}`)
+    .flatMap((k) => {
+      const v = queryParams[k];
+      if (Array.isArray(v)) {
+        return [...v].sort().map((item) => `${k}=${item}`);
+      }
+      return [`${k}=${v}`];
+    })
    .join("&");
  return `${subPath}:${sortedQs}:${body}:${timestamp}`;
 }
@@ -4,13 +4,29 @@ import { getConfig } from "../config.js";
 import { exitOnError, printResult } from "../output.js";
 import { validateAddress, validateChain } from "../validate.js";

+// Parse token age string. If a unit suffix is present (s/m), use it as-is.
+// Bare numbers (no unit) are treated as minutes with a warning.
+function parseDuration(value: string): string {
+  if (/^\d+(\.\d+)?[sm]$/.test(value)) return value;
+  if (/^\d+(\.\d+)?$/.test(value)) {
+    console.warn(
+      `[gmgn-cli] Warning: no unit specified for duration "${value}" — treating as minutes (${value}m). Use a suffix to be explicit: ${value}s for seconds or ${value}m for minutes.`
+    );
+    return `${value}m`;
+  }
+  console.error(
+    `[gmgn-cli] Invalid duration "${value}". Use seconds (e.g. 30s) or minutes (e.g. 0.5m / 1m / 5m).`
+  );
+  process.exit(1);
+}
+
 export function registerMarketCommands(program: Command): void {
  const market = program.command("market").description("Market data commands");

  market
    .command("kline")
    .description("Get token K-line (candlestick) data")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .requiredOption("--address <address>", "Token contract address")
    .requiredOption("--resolution <resolution>", "Candlestick resolution: 1m / 5m / 15m / 1h / 4h / 1d")
    .option("--from <timestamp>", "Start time (Unix seconds)", parseInt)
@@ -35,7 +51,7 @@ export function registerMarketCommands(program: Command): void {
  market
    .command("trending")
    .description("Get trending token swap data")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .requiredOption("--interval <interval>", "Time interval: 1m / 5m / 1h / 6h / 24h")
    .option("--limit <n>", "Number of results (default 100, max 100)", parseInt)
    .option("--order-by <field>", "Sort field: default / volume / swaps / marketcap / holder_count / price / change1h / ... (see docs for full list)")
@@ -76,6 +92,8 @@ export function registerMarketCommands(program: Command): void {
      trenchesCmd.option(`--${flag} <${def.type}>`, def.desc, parseInt);
    } else if (def.type === "float") {
      trenchesCmd.option(`--${flag} <${def.type}>`, def.desc, parseFloat);
+    } else if (def.type === "duration") {
+      trenchesCmd.option(`--${flag} <duration>`, def.desc, parseDuration);
    } else {
      trenchesCmd.option(`--${flag} <value>`, def.desc);
    }
@@ -169,7 +187,7 @@ export function registerMarketCommands(program: Command): void {

 // ---- Trenches filter field definitions ----

-type TrenchesFieldType = "int" | "float" | "string";
+type TrenchesFieldType = "int" | "float" | "string" | "duration";

 interface TrenchesFilterField {
  api: string;
@@ -201,8 +219,8 @@ const TRENCHES_FILTER_FIELDS: TrenchesFilterField[] = [
  { api: "min_liquidity",     type: "float",  desc: "Min liquidity (USD)" },
  { api: "max_liquidity",     type: "float",  desc: "Max liquidity (USD)" },
  // Token age
-  { api: "min_created",       type: "string", desc: "Min token age (e.g. 1m / 5m / 30m / 1h / 6h / 24h)" },
-  { api: "max_created",       type: "string", desc: "Max token age (e.g. 1m / 5m / 30m / 1h / 6h / 24h)" },
+  { api: "min_created",       type: "duration", desc: "Min token age — unit recommended: seconds (e.g. 30s) or minutes (e.g. 0.5m / 1m / 5m / 30m). Bare numbers treated as minutes." },
+  { api: "max_created",       type: "duration", desc: "Max token age — unit recommended: seconds (e.g. 30s) or minutes (e.g. 0.5m / 1m / 5m / 30m). Bare numbers treated as minutes." },
  // Holders
  { api: "min_holder_count",  type: "int",    desc: "Min holder count" },
  { api: "max_holder_count",  type: "int",    desc: "Max holder count" },
@@ -272,13 +290,14 @@ const TRENCHES_FILTER_PRESETS: Record<string, Record<string, number | string>> =
 };

 // Convert API snake_case field to Commander.js opts key
-// Commander.js camelCase: only converts -[a-z] patterns, digits stay as-is
-// e.g. min_volume_24h → min-volume-24h → minVolume-24h (digit prefix -24 is NOT converted)
-// e.g. min_smart_degen_count → min-smart-degen-count → minSmartDegenCount (all letters, converts fully)
+// Commander.js camelCase: converts -[a-z] to uppercase, and removes hyphen before digits
+// e.g. min_volume_24h → min-volume-24h → minVolume-24h → minVolume24h
+// e.g. min_smart_degen_count → min-smart-degen-count → minSmartDegenCount
 function apiFieldToCliKey(apiField: string): string {
  return apiField
    .replace(/_/g, '-')
-    .replace(/-([a-z])/g, (_, c: string) => c.toUpperCase());
+    .replace(/-([a-z])/g, (_, c: string) => c.toUpperCase())
+    .replace(/-(\d)/g, '$1');
 }

 // Client-side sort helpers (API does not support server-side sort for trenches)
@@ -10,7 +10,7 @@ export function registerPortfolioCommands(program: Command): void {
  portfolio
    .command("holdings")
    .description("Get wallet token holdings")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .requiredOption("--wallet <address>", "Wallet address")
    .option("--limit <n>", "Page size (default 20, max 50)", parseInt, 20)
    .option("--cursor <cursor>", "Pagination cursor")
@@ -46,7 +46,7 @@ export function registerPortfolioCommands(program: Command): void {
  portfolio
    .command("activity")
    .description("Get wallet transaction activity")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .requiredOption("--wallet <address>", "Wallet address")
    .option("--token <address>", "Filter by token contract address")
    .option("--limit <n>", "Page size", parseInt)
@@ -71,7 +71,7 @@ export function registerPortfolioCommands(program: Command): void {
  portfolio
    .command("stats")
    .description("Get wallet trading statistics (supports multiple wallets)")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .requiredOption("--wallet <address...>", "Wallet address(es), repeatable")
    .option("--period <period>", "Stats period: 7d / 30d", "7d")
    .option("--raw", "Output raw JSON")
@@ -96,7 +96,7 @@ export function registerPortfolioCommands(program: Command): void {
  portfolio
    .command("token-balance")
    .description("Get wallet token balance for a single token")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .requiredOption("--wallet <address>", "Wallet address")
    .requiredOption("--token <address>", "Token contract address")
    .option("--raw", "Output raw JSON")
@@ -112,7 +112,7 @@ export function registerPortfolioCommands(program: Command): void {
  portfolio
    .command("created-tokens")
    .description("Get tokens created by a developer wallet")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .requiredOption("--wallet <address>", "Developer wallet address")
    .option("--order-by <field>", "Sort field: market_cap / token_ath_mc")
    .option("--direction <dir>", "Sort direction: asc / desc")
@@ -8,7 +8,7 @@ export function registerSwapCommands(program: Command): void {
  program
    .command("swap")
    .description("Submit a token swap")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth ")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .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")
@@ -76,7 +76,7 @@ export function registerSwapCommands(program: Command): void {
  order
    .command("quote")
    .description("Get a swap quote without submitting a transaction (requires critical auth)")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base (requires GMGN_PRIVATE_KEY)")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth (requires GMGN_PRIVATE_KEY)")
    .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")
@@ -112,7 +112,7 @@ export function registerSwapCommands(program: Command): void {
  program
    .command("multi-swap")
    .description("Submit token swaps across multiple wallets concurrently (up to 100 wallets)")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .requiredOption("--accounts <addresses>", "Comma-separated wallet addresses (all must be bound to the API Key)")
    .requiredOption("--input-token <address>", "Input token contract address")
    .requiredOption("--output-token <address>", "Output token contract address")
@@ -186,7 +186,7 @@ export function registerSwapCommands(program: Command): void {
  strategy
    .command("create")
    .description("Create a limit/strategy order (requires private key)")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .requiredOption("--from <address>", "Wallet address (must match API Key binding)")
    .requiredOption("--base-token <address>", "Base token contract address")
    .requiredOption("--quote-token <address>", "Quote token contract address")
@@ -243,7 +243,7 @@ export function registerSwapCommands(program: Command): void {
  strategy
    .command("list")
    .description("List strategy orders (requires private key)")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .option("--type <type>", "open (default) / history")
    .option("--from <address>", "Filter by wallet address")
    .option("--group-tag <tag>", "Filter by group: LimitOrder / STMix")
@@ -268,7 +268,7 @@ export function registerSwapCommands(program: Command): void {
  strategy
    .command("cancel")
    .description("Cancel a strategy order (requires private key)")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .requiredOption("--from <address>", "Wallet address (must match API Key binding)")
    .requiredOption("--order-id <id>", "Order ID to cancel")
    .option("--order-type <type>", "Order type: limit_order / smart_trade")
@@ -10,7 +10,7 @@ export function registerTokenCommands(program: Command): void {
  token
    .command("info")
    .description("Get token basic information and realtime price")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .requiredOption("--address <address>", "Token contract address")
    .option("--raw", "Output raw JSON")
    .action(async (opts) => {
@@ -24,7 +24,7 @@ export function registerTokenCommands(program: Command): void {
  token
    .command("security")
    .description("Get token security metrics")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .requiredOption("--address <address>", "Token contract address")
    .option("--raw", "Output raw JSON")
    .action(async (opts) => {
@@ -38,7 +38,7 @@ export function registerTokenCommands(program: Command): void {
  token
    .command("pool")
    .description("Get token liquidity pool information")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .requiredOption("--address <address>", "Token contract address")
    .option("--raw", "Output raw JSON")
    .action(async (opts) => {
@@ -52,12 +52,12 @@ export function registerTokenCommands(program: Command): void {
  token
    .command("holders")
    .description("Get top token holders")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .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")
+    .option("--tag <tag>", "Wallet tag filter: smart_degen / renowned / fresh_wallet / dev / sniper / rat_trader / bundler / transfer_in / dex_bot / bluechip_owner")
    .option("--raw", "Output raw JSON")
    .action(async (opts) => {
      validateChain(opts.chain);
@@ -75,12 +75,12 @@ export function registerTokenCommands(program: Command): void {
  token
    .command("traders")
    .description("Get top token traders")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .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")
+    .option("--tag <tag>", "Wallet tag filter: smart_degen / renowned / fresh_wallet / dev / sniper / rat_trader / bundler / transfer_in / dex_bot / bluechip_owner")
    .option("--raw", "Output raw JSON")
    .action(async (opts) => {
      validateChain(opts.chain);
@@ -10,7 +10,7 @@ export function registerTrackCommands(program: Command): void {
  track
    .command("follow-wallet")
    .description("Get follow-wallet trade records")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .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")
@@ -35,7 +35,7 @@ export function registerTrackCommands(program: Command): void {
  track
    .command("kol")
    .description("Get KOL trade records")
-    .option("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .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")
@@ -52,7 +52,7 @@ export function registerTrackCommands(program: Command): void {
  track
    .command("smartmoney")
    .description("Get Smart Money trade records")
-    .option("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
    .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")
@@ -3,9 +3,9 @@ import { homedir } from "os";
 import { join } from "path";


-// Load global config first (~/.config/gmgn/.env), then project .env (project takes precedence)
-loadDotenv({ path: join(homedir(), ".config", "gmgn", ".env") });
-loadDotenv({ override: true });
+// Load global config first (~/.config/gmgn/.env, takes precedence), then project .env (supplements only)
+loadDotenv({ path: join(homedir(), ".config", "gmgn", ".env"), override: true });
+loadDotenv();

 export interface Config {
  apiKey: string;
@@ -15,7 +15,7 @@ export interface Config {

 let _config: Config | null = null;
 const PRIVATE_KEY_REQUIRED_MSG =
-  "GMGN_PRIVATE_KEY is required for critical-auth commands (swap and all order commands)";
+  "GMGN_PRIVATE_KEY is required for critical-auth commands (swap, order, and follow-wallet commands)";

 export function getConfig(requirePrivateKey = false): Config {
  if (_config) {
@@ -39,7 +39,7 @@ export function getConfig(requirePrivateKey = false): Config {
    die(PRIVATE_KEY_REQUIRED_MSG);
  }

-  const host = process.env.GMGN_HOST ?? "https://openapi.gmgn.ai";
+  const host = "https://openapi.gmgn.ai";
  _config = { apiKey: apiKey!, privateKeyPem, host };
  return _config;
 }
Author	SHA1	Message	Date
GMGN.AI	123bdba738	1.3.0	2026-05-14 20:47:03 +08:00
GMGN.AI	1d03fb1672	1.2.10	2026-05-14 20:46:10 +08:00
GMGN.AI	6f79600869	Merge pull request #122 from GumpOnchain/docs/token-native-transfer-shared-funding docs(token): move native_transfer to Shared Funding section with updated description	2026-05-14 20:44:38 +08:00
GMGN.AI	12ab55bb63	docs(token): move native_transfer to Shared Funding section with updated description native_transfer records the first native token (SOL/BNB/ETH) transfer into a wallet, not the most recent — it indicates the original funding source. Wallets sharing the same native_transfer.address are likely funded from a common origin (coordinated wallets / same operator). Move it out of Last Transaction Records into its own Shared Funding section to reflect its distinct purpose. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-14 20:43:36 +08:00
GMGN.AI	aa09490a9b	Merge pull request #121 from GumpOnchain/fix/trenches-volume-filter fix(trenches): fix apiFieldToCliKey for numeric suffix flags (--min/max-volume-24h etc.)	2026-05-14 20:08:22 +08:00
GMGN.AI	2b6c220581	fix(trenches): fix apiFieldToCliKey to match Commander.js camelCase for numeric suffixes Commander.js removes hyphens before digits (e.g. -24h → 24h) but does not uppercase them. The previous regex only handled -[a-z] patterns, leaving a residual hyphen: minVolume-24h instead of minVolume24h. This caused all 24h-suffixed filter flags to be silently ignored: --min-volume-24h, --max-volume-24h, --min-net-buy-24h, --min-swaps-24h, --min-buys-24h, --min-sells-24h. Fix: add .replace(/-(\d)/g, '$1') to strip hyphens before digit sequences. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-14 19:53:45 +08:00
deepfeature	e181cba142	fix(skills): update rate limit settings for cooking, market, portfolio, swap, token, and track routes	2026-05-13 17:13:26 +08:00
deepfeature	ee04212098	1.2.9	2026-05-04 09:41:21 +08:00
deepfeature	e4496eafeb	fix(config): update dotenv loading order and simplify host assignment	2026-05-04 09:35:54 +08:00
GMGN.AI	f56cf1f966	Merge pull request #117 from GMGNAI/fix/remove-bluechip-owner-stat-fields fix(token): remove bluechip_owner_count and bluechip_owner_percentage from stat fields	2026-04-24 15:23:21 +08:00
David Lau	698ae707e8	fix(token): remove bluechip_owner_count and bluechip_owner_percentage from stat fields These fields were removed from the TokenStatData struct in the openapi-service and are no longer returned in the token info response. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-04-24 15:01:47 +08:00
GMGN.AI	34fc2f9e2a	1.2.8	2026-04-23 19:37:48 +08:00
GMGN.AI	5ef03579cf	Merge pull request #114 from gina888666/fix/swap-currency-address-warning fix(swap): add critical warning to Chain Currencies table to prevent address guessing	2026-04-23 19:30:20 +08:00
wuyanling	1d433724d3	fix(swap): add critical warning to Chain Currencies table to prevent address guessing AI models may use incorrect currency addresses from training data (e.g. So11111111111111111111111111111111111111111 vs the correct ...112), causing silent failures or misleading "jupiter has no route" errors. Added a warning above the table and wrapped all addresses in backticks for clarity. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-04-23 19:17:53 +08:00
GMGN.AI	26a50c7046	Merge pull request #113 from GMGNAI/feat/eth-chain-support feat(eth): add ETH chain support to multi-swap, strategy, kol, smartmoney, created-tokens	2026-04-23 18:17:32 +08:00
David Lau	56a3a60352	feat(eth): add ETH chain support to multi-swap, strategy, kol, smartmoney, created-tokens - multi-swap --chain: add eth - order strategy create/list/cancel --chain: add eth - track kol/smartmoney --chain: add eth, change to requiredOption - portfolio created-tokens --chain: add eth - SKILL.md files updated accordingly Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-04-23 18:16:58 +08:00
GMGN.AI	211f7d6fd0	docs(swap): remove USDC from ETH chain currencies (ETH-only for now) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-04-22 20:41:35 +08:00
GMGN.AI	5e1560188e	docs: remove USDC from ETH chain currencies (ETH-only for now) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-04-22 20:39:31 +08:00
GMGN.AI	08f7b66251	docs: add ETH chain to multi-chain descriptions in README Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-04-22 20:31:56 +08:00
GMGN.AI	48c596ab10	1.2.7	2026-04-22 19:31:47 +08:00
GMGN.AI	ec099ea399	Merge pull request #112 from GMGNAI/feat-add-eth-chain-support feat(eth): add Ethereum mainnet chain support (P0 commands)	2026-04-22 17:40:24 +08:00
David Lau	1012cfffb8	feat(eth): add Ethereum mainnet chain support (P0 commands) Add ETH chain support to all P0 commands across CLI and SKILL.md docs: Commands with ETH support added: - token info/security/pool/holders/traders - market kline/trending - portfolio info/holdings/activity/stats/token-balance - track follow-wallet - swap, order quote/get P1/P2 commands remain sol/bsc/base only: - track kol/smartmoney (P1) - multi-swap, order strategy create/list/cancel (P1) - portfolio created-tokens (P2) Also adds ETH chain currencies, explorer links, and gas price bounds to gmgn-swap SKILL.md. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-04-22 16:08:36 +08:00
GMGN.AI	f6f1d56b82	Merge pull request #111 from gina888666/fix/trenches-created-duration-unit fix(trenches): require unit suffix for --min-created / --max-created	2026-04-22 15:26:48 +08:00
wuyanling	b83422769f	fix(trenches): remove 1h example from min/max-created desc, align with s/m only Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-04-22 15:22:44 +08:00
GMGN.AI	8922811e04	Merge pull request #110 from GMGNAI/expand-trader-holder-tag-filter feat(token): expand --tag filter for holders and traders to all 10 values	2026-04-22 15:14:20 +08:00
wuyanling	cc1cb48db9	fix(trenches): treat bare duration numbers as minutes with warning, update skill docs - parseDuration: bare numbers now default to minutes (e.g. "5" → "5m") instead of hard error - Print a warning to stderr so users know the implicit conversion is happening - Update SKILL.md: document unit suffix recommendation and bare-number fallback behavior Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-04-22 11:52:01 +08:00
wuyanling	981600f170	fix(trenches): require unit suffix for --min-created / --max-created Bare numbers like 0.5 were silently accepted but caused inconsistent server-side filtering. This change: - Adds a parseDuration() validator that rejects values without a unit - Accepts seconds (e.g. 30s) and minutes (e.g. 0.5m / 1m / 5m) - Prints a clear error message when a bare number is passed - Updates desc strings to document the required unit format - Adds a new TrenchesFieldType 'duration' to distinguish these fields	2026-04-22 11:37:44 +08:00
David Lau	1f49d61363	feat(token): expand --tag filter for holders and traders to all 10 values Update --tag option description and SKILL.md docs to reflect the full backend allowlist: smart_degen, renowned, fresh_wallet, dev, sniper, rat_trader, bundler, transfer_in, dex_bot, bluechip_owner. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-04-21 16:42:06 +08:00
GMGN.AI	3046c6d6cd	1.2.6	2026-04-20 11:46:18 +08:00
GMGN.AI	ee4838d565	Merge pull request #108 from GumpOnchain/fix/follow-wallet-critical-auth fix(track): switch follow-wallet to critical auth (fix HTTP 401 AUTH_INVALID)	2026-04-20 11:44:20 +08:00
GMGN.AI	f19a1919da	fix(track): switch follow-wallet to critical auth and fix signer array support GET /v1/trade/follow_wallet requires X-Signature (critical auth) but was called via normalRequest (API Key only), causing HTTP 401 AUTH_INVALID with "missing signature". - OpenApiClient: getFollowWallet now calls criticalRequest; criticalRequest queryExtra type widened to accept string[] to support the --filter option - signer: buildMessage handles string[] values as sorted repeated k=v pairs, consistent with buildUrl / URLSearchParams serialization - config: update PRIVATE_KEY_REQUIRED_MSG to include follow-wallet - SKILL.md: prerequisites note GMGN_PRIVATE_KEY for follow-wallet; first-time setup now saves private key to ~/.config/gmgn/.env and removes /tmp copy; Notes section corrected to reflect split auth modes - CLAUDE.md: Auth Modes table updated — follow-wallet moved to Critical row Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-04-20 11:42:56 +08:00
davidsx	4cfe0e0fb5	Merge pull request #107 from GMGNAI/docs/market-signal-disallow-types-14-16 docs(gmgn-market): document token_signal types 14–16 rejected by API	2026-04-20 11:42:04 +08:00
David Lau	5755206b58	docs(gmgn-market): document token_signal types 14–16 rejected by API Align SKILL with OpenAPI validation: signal_type must not include 14, 15, or 16 (400 BAD_REQUEST). Update examples and clarify behavior when --signal-type is omitted. Made-with: Cursor	2026-04-20 11:41:40 +08:00
davidsx	6ab9cb108b	Update SKILL.md	2026-04-17 14:37:42 +08:00