1.3.2

feat(swap): promote gas-price to top-level command, support all chains

package-lock.json

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

package.json

@@ -1,6 +1,6 @@
 {
   "name": "gmgn-cli",
-  "version": "1.2.9",
+  "version": "1.3.2",
   "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

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

@@ -1,7 +1,7 @@
 ---
 name: gmgn-swap
 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 gas-price --chain <eth|bsc|base>] | [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> ...]"
+argument-hint: "[--chain <chain> --from <wallet> --input-token <addr> --output-token <addr> --amount <n>] | [order get --chain <chain> --order-id <id>] | [gas-price --chain <eth|bsc|base|sol>] | [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"
 ---
@@ -24,7 +24,7 @@ Use the `gmgn-cli` tool to submit a token swap or query an existing order. `GMGN
 
 - **Currency tokens** — Each chain has designated currency tokens (SOL, BNB, ETH, USDC). These are the base assets used to buy other tokens or receive swap proceeds. Their contract addresses are fixed — look them up in the Chain Currencies table, never guess them.
 
-- **Anti-MEV** — MEV (Miner/Maximal Extractable Value) refers to frontrunning and sandwich attacks where bots exploit pending transactions. `--anti-mev` routes the transaction through protected channels to reduce this risk. **Recommended: always enable.** Default: on.
+- **Anti-MEV** — MEV (Miner/Maximal Extractable Value) refers to frontrunning and sandwich attacks where bots exploit pending transactions. `--anti-mev` routes the transaction through protected channels to reduce this risk. **Recommended: always enable.** Default: on. **Not supported on `base` chain.**
 
 - **Critical auth** — `swap` and all `order` subcommands require both `GMGN_API_KEY` and `GMGN_PRIVATE_KEY`. The private key never leaves the machine — the CLI uses it only for local signing and sends only the resulting signature.
 
@@ -49,7 +49,7 @@ Use the `gmgn-cli` tool to submit a token swap or query an existing order. `GMGN
 | `multi-swap` | Submit token swaps across multiple wallets concurrently (up to 100) |
 | `order quote` | Get a swap quote (no transaction submitted; requires critical auth) |
 | `order get` | Query order status |
-| `order gas-price` | Query recommended EVM gas price (low / average / high tiers); normal auth |
+| `gas-price` | Query recommended gas price (low / average / high tiers) for any chain; normal auth |
 | `order strategy create` | Create a limit/strategy order (requires private key) |
 | `order strategy list` | List strategy orders (requires private key) |
 | `order strategy cancel` | Cancel a strategy order (requires private key) |
@@ -80,7 +80,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 |
 |---------|-------|--------|
@@ -88,7 +88,7 @@ All swap-related routes used by this skill go through GMGN's leaky-bucket limite
 | `multi-swap` | `POST /v1/trade/multi_swap` | 5 |
 | `order quote` | `GET /v1/trade/quote` | 2 |
 | `order get` | `GET /v1/trade/query_order` | 1 |
-| `order gas-price` | `GET /v1/trade/gas_price` | 1 |
+| `gas-price` | `GET /v1/trade/gas_price` | 1 |
 
 When a request returns `429`:
 
@@ -184,7 +184,7 @@ gmgn-cli swap \
 | `--slippage <n>` | No | all | Slippage tolerance, e.g. `0.01` = 1%. **Mutually exclusive with `--auto-slippage`** — use one or the other. |
 | `--auto-slippage` | No | all | Enable automatic slippage. **Mutually exclusive with `--slippage`.** |
 | `--min-output <n>` | No | all | Minimum output amount |
-| `--anti-mev` | No | all | Enable anti-MEV protection — **recommended**; protects against frontrunning and sandwich attacks. Default: on |
+| `--anti-mev` | No | sol / bsc / eth | Enable anti-MEV protection — **recommended**; protects against frontrunning and sandwich attacks. Default: on. **Not supported on `base`.** |
 | `--priority-fee <sol>` | No | `sol` | Priority fee in SOL (≥ 0.00001). Required when using `--condition-orders` on SOL. |
 | `--tip-fee <n>` | No | `sol` / `bsc` | Tip fee (SOL ≥ 0.00001 / BSC ≥ 0.000001 BNB). Required when using `--condition-orders` on SOL. |
 | `--gas-price <gwei>` | No | `bsc` / `base` / `eth` | Gas price in gwei (BSC ≥ 0.05 / BASE/ETH ≥ 0.01). Required when using `--condition-orders` on BSC. Mutually exclusive with `--gas-level`. |
@@ -402,7 +402,7 @@ gmgn-cli multi-swap \
 | `--output-amount` | No* | all | JSON map of `wallet_address → target output amount` (smallest unit). |
 | `--slippage <n>` | No | all | Slippage tolerance, e.g. `0.01` = 1%. Mutually exclusive with `--auto-slippage`. |
 | `--auto-slippage` | No | all | Enable automatic slippage. |
-| `--anti-mev` | No | all | Enable anti-MEV protection. |
+| `--anti-mev` | No | sol / bsc / eth | Enable anti-MEV protection. Not supported on `base`. |
 | `--priority-fee <sol>` | No | `sol` | Priority fee in SOL (≥ 0.00001). Required when using `--condition-orders` on SOL. |
 | `--tip-fee <amount>` | No | `sol` / `bsc` | Tip fee (SOL ≥ 0.00001 / BSC ≥ 0.000001 BNB). Required when using `--condition-orders` on SOL. |
 | `--gas-price <gwei>` | No | `bsc` / `base` / `eth` | Gas price in gwei (BSC ≥ 0.05 / BASE/ETH ≥ 0.01). Required when using `--condition-orders` on BSC. Mutually exclusive with `--gas-level`. |
@@ -465,25 +465,44 @@ Response fields are shared with `swap` — see [`swap` / `order get` Response Fi
 
 ---
 
-## `order gas-price` Usage
+## `gas-price` Usage
 
-Query recommended EVM gas price tiers. Uses normal auth (API Key only — no private key required).
+Query recommended gas price tiers for any chain. Uses normal auth (API Key only — no private key required).
 
 ```bash
-gmgn-cli order gas-price --chain eth
-gmgn-cli order gas-price --chain bsc
-gmgn-cli order gas-price --chain base
+gmgn-cli gas-price --chain eth
+gmgn-cli gas-price --chain bsc
+gmgn-cli gas-price --chain base
+gmgn-cli gas-price --chain sol
 ```
 
-### `order gas-price` Response Fields
+### `gas-price` Response Fields
 
-| Field              | Type   | Description |
-| ------------------ | ------ | ---- |
-| `chain`            | string | Chain identifier |
-| `suggest_base_fee` | string | Suggested base fee (gwei) |
-| `low`              | string | Low-priority gas price (gwei) |
-| `average`          | string | Average-priority gas price (gwei) |
-| `high`             | string | High-priority gas price (gwei) |
+All fields are omitempty — fields unsupported by a chain are omitted. Units are chain-native (wei for EVM chains; lamports / chain-native for SOL).
+
+| Field                    | Type    | Description |
+| ------------------------ | ------- | ----------- |
+| `chain`                  | string  | Chain identifier |
+| `auto`                   | string  | Automatic gas price |
+| `auto_mev`               | string  | Anti-MEV automatic gas price |
+| `last_block`             | int64   | Latest block number |
+| `high`                   | string  | High-priority gas price |
+| `average`                | string  | Average-priority gas price |
+| `low`                    | string  | Low-priority gas price |
+| `suggest_base_fee`       | string  | Suggested base fee |
+| `high_prio_fee`          | string  | High-priority fee |
+| `average_prio_fee`       | string  | Average-priority fee |
+| `low_prio_fee`           | string  | Low-priority fee |
+| `high_prio_fee_mixed`    | string  | High mixed priority fee |
+| `average_prio_fee_mixed` | string  | Average mixed priority fee |
+| `low_prio_fee_mixed`     | string  | Low mixed priority fee |
+| `native_token_usd_price` | float32 | Native token USD price |
+| `high_estimate_time`     | int64   | Estimated confirmation time for high tier (seconds) |
+| `average_estimate_time`  | int64   | Estimated confirmation time for average tier (seconds) |
+| `low_estimate_time`      | int64   | Estimated confirmation time for low tier (seconds) |
+| `high_orign`             | string  | High-priority raw origin value |
+| `average_orign`          | string  | Average-priority raw origin value |
+| `low_orign`              | string  | Low-priority raw origin value |
 
 ---
 
@@ -540,7 +559,7 @@ gmgn-cli order strategy create \
 | `--gas-level` | No | `eth` | Gas price tier: `low` / `average` / `high`. Mutually exclusive with `--gas-price`. |
 | `--max-fee-per-gas` | No | `bsc` / `base` / `eth` | EIP-1559 max fee per gas. Clamped per chain minimums. |
 | `--max-priority-fee-per-gas` | No | `bsc` / `base` / `eth` | EIP-1559 max priority fee per gas. Clamped per chain minimums; capped to `--max-fee-per-gas`. |
-| `--anti-mev` | No | all | Enable anti-MEV protection |
+| `--anti-mev` | No | sol / bsc / eth | Enable anti-MEV protection. Not supported on `base`. |
 
 ### `order strategy create` Response Fields
 
@@ -618,7 +637,7 @@ gmgn-cli order strategy cancel \
 - `--amount` is in the **smallest unit** (e.g., lamports for SOL)
 - `order strategy create`, `order strategy list`, and `order strategy cancel` use critical auth (require `GMGN_PRIVATE_KEY`)
 - Use `--raw` to get single-line JSON for further processing
-- **Chain restrictions for fee flags** — see the `Chain` column in each parameter table above. `--priority-fee` and `--tip-fee` are SOL/BSC only; `--gas-price`, `--max-fee-per-gas`, `--max-priority-fee-per-gas` are BSC/BASE/ETH only; `--gas-level` and `--auto-fee` are ETH only. The server returns 400 if a chain-restricted flag is sent on the wrong chain.
+- **Chain restrictions for fee flags** — see the `Chain` column in each parameter table above. `--priority-fee` and `--tip-fee` are SOL/BSC only; `--gas-price`, `--max-fee-per-gas`, `--max-priority-fee-per-gas` are BSC/BASE/ETH only; `--gas-level` and `--auto-fee` are ETH only. The server returns 400 if a chain-restricted flag is sent on the wrong chain. (`gas-price` itself supports all four chains including `sol`.)
 - **EIP-1559 minimum values per chain:**
   - BSC: `max_fee_per_gas` and `max_priority_fee_per_gas` min 50 000 000 wei (≈ 0.05 gwei); passing `"0"` returns 400
   - BASE / ETH: `max_fee_per_gas` and `max_priority_fee_per_gas` min 200 000 wei

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 |
 |---------|-------|--------|
@@ -469,13 +469,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

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

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/swap.ts

@@ -73,55 +73,6 @@ export function registerSwapCommands(program: Command): void {
       printResult(data, opts.raw);
     });
 
-  const order = program.command("order").description("Order management commands");
-
-  order
-    .command("quote")
-    .description("Get a swap quote without submitting a transaction (requires critical auth)")
-    .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")
-    .requiredOption("--amount <amount>", "Input amount (smallest unit)")
-    .requiredOption("--slippage <n>", "Slippage tolerance (e.g. 0.01 = 1%)", parseFloat)
-    .option("--raw", "Output raw JSON")
-    .action(async (opts) => {
-      validateChain(opts.chain);
-      validateAddress(opts.from, opts.chain, "--from");
-      validateAddress(opts.inputToken, opts.chain, "--input-token");
-      validateAddress(opts.outputToken, opts.chain, "--output-token");
-      validatePositiveInt(opts.amount, "--amount");
-      const client = new OpenApiClient(getConfig(true));
-      const data = await client
-        .quoteOrder(opts.chain, opts.from, opts.inputToken, opts.outputToken, opts.amount, opts.slippage)
-        .catch(exitOnError);
-      printResult(data, opts.raw);
-    });
-
-  order
-    .command("get")
-    .description("Query order status (requires private key)")
-    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth / monad")
-    .requiredOption("--order-id <id>", "Order ID")
-    .option("--raw", "Output raw JSON")
-    .action(async (opts) => {
-      validateChain(opts.chain);
-      const client = new OpenApiClient(getConfig(true));
-      const data = await client.queryOrder(opts.orderId, opts.chain).catch(exitOnError);
-      printResult(data, opts.raw);
-    });
-
-  order
-    .command("gas-price")
-    .description("Query recommended EVM gas price (normal auth; eth / bsc / base)")
-    .requiredOption("--chain <chain>", "EVM chain: eth / bsc / base")
-    .option("--raw", "Output raw JSON")
-    .action(async (opts) => {
-      const client = new OpenApiClient(getConfig(false));
-      const data = await client.getGasPrice(opts.chain).catch(exitOnError);
-      printResult(data, opts.raw);
-    });
-
   program
     .command("multi-swap")
     .description("Submit token swaps across multiple wallets concurrently (up to 100 wallets)")
@@ -194,6 +145,55 @@ export function registerSwapCommands(program: Command): void {
       printResult(data, opts.raw);
     });
 
+  const order = program.command("order").description("Order management commands");
+
+  order
+    .command("quote")
+    .description("Get a swap quote without submitting a transaction (requires critical auth)")
+    .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")
+    .requiredOption("--amount <amount>", "Input amount (smallest unit)")
+    .requiredOption("--slippage <n>", "Slippage tolerance (e.g. 0.01 = 1%)", parseFloat)
+    .option("--raw", "Output raw JSON")
+    .action(async (opts) => {
+      validateChain(opts.chain);
+      validateAddress(opts.from, opts.chain, "--from");
+      validateAddress(opts.inputToken, opts.chain, "--input-token");
+      validateAddress(opts.outputToken, opts.chain, "--output-token");
+      validatePositiveInt(opts.amount, "--amount");
+      const client = new OpenApiClient(getConfig(true));
+      const data = await client
+        .quoteOrder(opts.chain, opts.from, opts.inputToken, opts.outputToken, opts.amount, opts.slippage)
+        .catch(exitOnError);
+      printResult(data, opts.raw);
+    });
+
+  order
+    .command("get")
+    .description("Query order status (requires private key)")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth / monad")
+    .requiredOption("--order-id <id>", "Order ID")
+    .option("--raw", "Output raw JSON")
+    .action(async (opts) => {
+      validateChain(opts.chain);
+      const client = new OpenApiClient(getConfig(true));
+      const data = await client.queryOrder(opts.orderId, opts.chain).catch(exitOnError);
+      printResult(data, opts.raw);
+    });
+
+  program
+    .command("gas-price")
+    .description("Query recommended gas price tiers for any chain (normal auth; eth / bsc / base / sol)")
+    .requiredOption("--chain <chain>", "Chain: eth / bsc / base / sol")
+    .option("--raw", "Output raw JSON")
+    .action(async (opts) => {
+      const client = new OpenApiClient(getConfig(false));
+      const data = await client.getGasPrice(opts.chain).catch(exitOnError);
+      printResult(data, opts.raw);
+    });
+
   const strategy = order.command("strategy").description("Limit/strategy order management");
 
   strategy