1.3.0

docs(token): move native_transfer to Shared Funding section with updated description

Readme.md

@@ -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 |
 |------|-------------|
@@ -673,7 +673,7 @@ gmgn-cli cooking \
 | Commands | Chains | Chain Currencies |
 |----------|--------|-----------------|
 | 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, USDC |
+| swap / order | `sol` / `bsc` / `base` / `eth` | sol: SOL, USDC · bsc: BNB, USDC · base: ETH, USDC · eth: ETH |
 
 ---
 

Readme.zh.md

@@ -22,7 +22,7 @@
 
 ### 1. 链上实时数据查询快
 
-SOL / BSC / Base 多链数据每次查询均为实时，支持多参数个性化调用，无快照缓存，方便AI Agent实时决策（包括不限于下表）。
+SOL / BSC / Base / ETH 多链数据每次查询均为实时，支持多参数个性化调用，无快照缓存，方便AI Agent实时决策（包括不限于下表）。
 
 | 数据类型 | 粒度 |
 |---------|------|
@@ -697,7 +697,7 @@ gmgn-cli cooking \
 | 接口类型 | 支持的链 | 链原生货币 |
 |----------|----------|-----------|
 | 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、USDC |
+| swap / order | `sol` / `bsc` / `base` / `eth` | sol: SOL、USDC · bsc: BNB、USDC · base: ETH、USDC · eth: ETH |
 
 ---
 

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "gmgn-cli",
-  "version": "1.2.7",
+  "version": "1.3.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "gmgn-cli",
-      "version": "1.2.7",
+      "version": "1.3.0",
       "license": "MIT",
       "dependencies": {
         "commander": "^12.1.0",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "gmgn-cli",
-  "version": "1.2.7",
+  "version": "1.3.0",
   "description": "GMGN OpenAPI CLI — call GMGN market, token, portfolio and swap APIs from the command line",
   "type": "module",
   "bin": {

skills/gmgn-cooking/SKILL.md

@@ -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 |
 |---------|--------|

skills/gmgn-market/SKILL.md

@@ -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 |
 |---------|-------|--------|

skills/gmgn-portfolio/SKILL.md

@@ -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` / `eth` (info / holdings / activity / stats / token-balance); `sol` / `bsc` / `base` (created-tokens)
+`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 |
 |---------|-------|--------|

skills/gmgn-swap/SKILL.md

@@ -61,12 +61,14 @@ Use the `gmgn-cli` tool to submit a token swap or query an existing order. `GMGN
 
 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).
 
+> ⚠️ **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), USDC (`0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48`) |
+| `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 |
@@ -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) |

skills/gmgn-token/SKILL.md

@@ -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 |
 |---------|-------|--------|
@@ -249,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 |
@@ -420,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 |

skills/gmgn-track/SKILL.md

@@ -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, 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>]"
+argument-hint: "<follow-wallet|kol|smartmoney> --chain <sol|bsc|base|eth> [--wallet <wallet_address>]"
 metadata:
   cliHelp: "gmgn-cli track --help"
 ---
@@ -55,7 +55,7 @@ Use the `gmgn-cli` tool to query on-chain tracking data based on the user's requ
 
 ## Supported Chains
 
-`sol` / `bsc` / `base` / `eth` (follow-wallet); `sol` / `bsc` / `base` (kol / smartmoney)
+`sol` / `bsc` / `base` / `eth`
 
 ## Prerequisites
 
@@ -65,7 +65,7 @@ Use the `gmgn-cli` tool to query on-chain tracking data based on the user's requ
 
 ## 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 |
 |---------|-------|--------|
@@ -142,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) |
 

src/commands/market.ts

@@ -290,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)

src/commands/portfolio.ts

@@ -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")

src/commands/swap.ts

@@ -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")

src/commands/track.ts

@@ -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")

src/config.ts

@@ -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;
@@ -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;
 }