1.4.7

chore: ignore local Claude Code dev configs
Merge pull request #167 from GMGNAI/feat-quote-exist-auth
2026-07-28 17:27:43 +00:00 · 2026-06-24 16:23:07 +08:00 · 2026-06-24 16:22:55 +08:00 · 2026-06-24 16:21:20 +08:00 · 2026-06-24 16:13:37 +08:00 · 2026-06-22 16:55:51 +08:00
16 changed files with 518 additions and 127 deletions
@@ -18,3 +18,8 @@ dist

 # Internal / testing (not for public release)
 testing/
+
+# Local Claude Code configs (dev environment only)
+.claude/
+.agents/
+skills-lock.json
@@ -93,8 +93,8 @@ EOF

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

 ## SKILL.md Authoring Rules

@@ -505,6 +505,9 @@ gmgn-cli portfolio created-tokens --chain sol --wallet <addr>
 ### Track

 ```bash
+# Followed token map for a wallet
+gmgn-cli track follow-tokens --chain sol --wallet <wallet_address>
+
 # Follow-wallet trade records
 gmgn-cli track follow-wallet --chain sol
 gmgn-cli track follow-wallet --chain sol --limit 20 --min-amount-usd 1000
@@ -528,7 +531,7 @@ gmgn-cli swap \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --amount 1000000 \
-  --slippage 0.01
+  --slippage 30

 # Submit swap with automatic slippage
 gmgn-cli swap \
@@ -555,7 +558,7 @@ gmgn-cli order quote \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --amount 1000000 \
-  --slippage 0.01
+  --slippage 30

 # Quotes use signed auth and require GMGN_PRIVATE_KEY on every chain
 gmgn-cli order quote \
@@ -564,7 +567,7 @@ gmgn-cli order quote \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --amount 1000000000000000000 \
-  --slippage 0.01
+  --slippage 30

 # Query order
 gmgn-cli order get --chain sol --order-id <order-id>
@@ -582,7 +585,7 @@ gmgn-cli multi-swap \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --input-amount '{"<addr1>":"1000000","<addr2>":"2000000"}' \
-  --slippage 0.01
+  --slippage 30
 ```

 > `order quote` uses signed auth on `sol` / `bsc` / `base` / `eth` and requires `GMGN_PRIVATE_KEY`.
@@ -597,7 +600,7 @@ gmgn-cli swap \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --amount <amount> \
-  --slippage 0.01 \
+  --slippage 30 \
  --gas-level high

 # Let GMGN auto-select the optimal gas fee for condition orders
@@ -607,7 +610,7 @@ gmgn-cli swap \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --amount <amount> \
-  --slippage 0.01 \
+  --slippage 30 \
  --condition-orders '[...]' \
  --auto-fee
 ```
@@ -627,7 +630,7 @@ gmgn-cli swap \
  --input-token So11111111111111111111111111111111111111112 \
  --output-token <token_A_address> \
  --amount 10000000 \
-  --slippage 0.3 \
+  --slippage 30 \
  --anti-mev \
  --condition-orders '[{"order_type":"profit_stop","side":"sell","price_scale":"100","sell_ratio":"50"},{"order_type":"profit_stop","side":"sell","price_scale":"300","sell_ratio":"100"},{"order_type":"loss_stop","side":"sell","price_scale":"65","sell_ratio":"100"}]' \
  --sell-ratio-type hold_amount
@@ -646,7 +649,7 @@ gmgn-cli swap \
  --input-token So11111111111111111111111111111111111111112 \
  --output-token <token_A_address> \
  --amount 10000000 \
-  --slippage 0.3 \
+  --slippage 30 \
  --anti-mev \
  --condition-orders '[{"order_type":"profit_stop","side":"sell","price_scale":"100","sell_ratio":"50"},{"order_type":"profit_stop","side":"sell","price_scale":"300","sell_ratio":"50"},{"order_type":"loss_stop","side":"sell","price_scale":"65","sell_ratio":"100"}]' \
  --sell-ratio-type buy_amount
@@ -668,7 +671,7 @@ gmgn-cli order strategy create \
  --sub-order-type take_profit \
  --check-price 0.002 \
  --amount-in-percent 100 \
-  --slippage 0.01
+  --slippage 30

 # Create a stop-loss order
 gmgn-cli order strategy create \
@@ -679,7 +682,7 @@ gmgn-cli order strategy create \
  --sub-order-type stop_loss \
  --check-price 0.0005 \
  --amount-in-percent 100 \
-  --slippage 0.01
+  --slippage 30

 # List open strategy orders (requires private key)
 gmgn-cli order strategy list --chain sol
@@ -698,7 +701,7 @@ gmgn-cli cooking \
  --input-token So11111111111111111111111111111111111111112 \
  --output-token <token_address> \
  --amount 1000000000 \
-  --slippage 0.3 \
+  --slippage 30 \
  --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"}]'
 ```

@@ -529,6 +529,9 @@ gmgn-cli portfolio created-tokens --chain sol --wallet <addr>
 ### Track

 ```bash
+# 查询钱包收藏的代币列表
+gmgn-cli track follow-tokens --chain sol --wallet <wallet_address>
+
 # 追踪关注钱包的交易动态
 gmgn-cli track follow-wallet --chain sol
 gmgn-cli track follow-wallet --chain sol --limit 20 --min-amount-usd 1000
@@ -552,7 +555,7 @@ gmgn-cli swap \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --amount 1000000 \
-  --slippage 0.01
+  --slippage 30

 # 提交兑换（自动滑点）
 gmgn-cli swap \
@@ -579,7 +582,7 @@ gmgn-cli order quote \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --amount 1000000 \
-  --slippage 0.01
+  --slippage 30

 # 所有链上的 quote 都走关键鉴权，需要 GMGN_PRIVATE_KEY
 gmgn-cli order quote \
@@ -588,7 +591,7 @@ gmgn-cli order quote \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --amount 1000000000000000000 \
-  --slippage 0.01
+  --slippage 30

 # 查询订单状态
 gmgn-cli order get --chain sol --order-id <order-id>
@@ -606,7 +609,7 @@ gmgn-cli multi-swap \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --input-amount '{"<addr1>":"1000000","<addr2>":"2000000"}' \
-  --slippage 0.01
+  --slippage 30
 ```

 > `order quote` 在 `sol` / `bsc` / `base` / `eth` 上都走关键鉴权，必须配置 `GMGN_PRIVATE_KEY`。
@@ -621,7 +624,7 @@ gmgn-cli swap \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --amount <amount> \
-  --slippage 0.01 \
+  --slippage 30 \
  --gas-level high

 # 策略单（condition-orders）由 GMGN 自动选择最优 Gas Fee
@@ -631,7 +634,7 @@ gmgn-cli swap \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --amount <amount> \
-  --slippage 0.01 \
+  --slippage 30 \
  --condition-orders '[...]' \
  --auto-fee
 ```
@@ -651,7 +654,7 @@ gmgn-cli swap \
  --input-token So11111111111111111111111111111111111111112 \
  --output-token <token_A_address> \
  --amount 10000000 \
-  --slippage 0.3 \
+  --slippage 30 \
  --anti-mev \
  --condition-orders '[{"order_type":"profit_stop","side":"sell","price_scale":"100","sell_ratio":"50"},{"order_type":"profit_stop","side":"sell","price_scale":"300","sell_ratio":"100"},{"order_type":"loss_stop","side":"sell","price_scale":"65","sell_ratio":"100"}]' \
  --sell-ratio-type hold_amount
@@ -670,7 +673,7 @@ gmgn-cli swap \
  --input-token So11111111111111111111111111111111111111112 \
  --output-token <token_A_address> \
  --amount 10000000 \
-  --slippage 0.3 \
+  --slippage 30 \
  --anti-mev \
  --condition-orders '[{"order_type":"profit_stop","side":"sell","price_scale":"100","sell_ratio":"50"},{"order_type":"profit_stop","side":"sell","price_scale":"300","sell_ratio":"50"},{"order_type":"loss_stop","side":"sell","price_scale":"65","sell_ratio":"100"}]' \
  --sell-ratio-type buy_amount
@@ -692,7 +695,7 @@ gmgn-cli order strategy create \
  --sub-order-type take_profit \
  --check-price 0.002 \
  --amount-in-percent 100 \
-  --slippage 0.01
+  --slippage 30

 # 创建止损单
 gmgn-cli order strategy create \
@@ -703,7 +706,7 @@ gmgn-cli order strategy create \
  --sub-order-type stop_loss \
  --check-price 0.0005 \
  --amount-in-percent 100 \
-  --slippage 0.01
+  --slippage 30

 # 查看当前挂单（需要私钥）
 gmgn-cli order strategy list --chain sol
@@ -722,7 +725,7 @@ gmgn-cli cooking \
  --input-token So11111111111111111111111111111111111111112 \
  --output-token <token_address> \
  --amount 1000000000 \
-  --slippage 0.3 \
+  --slippage 30 \
  --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"}]'
 ```

@@ -349,6 +349,54 @@ gmgn-cli market signal --chain sol --groups '<json_array>' [--raw]

 ---

+## track follow-tokens
+
+Query the followed token list for a wallet. Returns a paginated list of tokens the wallet has bookmarked on GMGN, with full market data. API Key auth only.
+
+```bash
+gmgn-cli track follow-tokens \
+  --chain <chain> \
+  --wallet <wallet_address> \
+  [--group-id <id>] \
+  [--order-by <field>] \
+  [--direction <asc|desc>] \
+  [--limit <n>] \
+  [--cursor <cursor>] \
+  [--raw]
+```
+
+| Option | Required | Description |
+|--------|----------|-------------|
+| `--chain` | Yes | `sol` / `bsc` / `base` / `eth` |
+| `--wallet` | Yes | Wallet address |
+| `--group-id` | No | `all_group` (all tokens), `default`, or a user-defined group ID |
+| `--interval` | No | Time interval for price change stats: `1m` / `5m` / `1h` / `6h` / `24h` |
+| `--order-by` | No | `created_at` / `swaps` / `volume` / `market_cap` / `liquidity` / `price` / `open_timestamp` |
+| `--direction` | No | Sort direction: `asc` / `desc` |
+| `--limit` | No | Page size |
+| `--cursor` | No | Pagination cursor from previous response |
+| `--search` | No | Search by token name or address |
+
+---
+
+## track follow-token-groups
+
+Query the follow token group names for a wallet. Returns the groups a wallet uses to organise its followed tokens on GMGN. API Key auth only.
+
+```bash
+gmgn-cli track follow-token-groups \
+  --chain <chain> \
+  --wallet <wallet_address> \
+  [--raw]
+```
+
+| Option | Required | Description |
+|--------|----------|-------------|
+| `--chain` | Yes | `sol` / `bsc` / `base` / `eth` |
+| `--wallet` | Yes | Wallet address |
+
+---
+
 ## portfolio follow-wallet

 Query follow-wallet trade records. Returns trades from wallets you personally follow on the GMGN platform. The follow list is resolved automatically from the GMGN user account bound to the API Key — `--wallet` is optional. Signed auth (API Key + private key signature).
@@ -411,7 +459,7 @@ gmgn-cli track smartmoney [--chain <chain>] [--limit <n>] [--side <side>] [--raw

 ## order quote

-Get a swap quote without submitting a transaction. All supported quote chains use signed auth and require `GMGN_PRIVATE_KEY`.
+Get a swap quote without submitting a transaction. Uses normal auth — only `GMGN_API_KEY` is required, no `GMGN_PRIVATE_KEY` needed.

 ```bash
 npx gmgn-cli order quote \
@@ -426,12 +474,12 @@ npx gmgn-cli order quote \

 | Option | Required | Description |
 |--------|----------|-------------|
-| `--chain` | Yes | `sol` / `bsc` / `base` (all require `GMGN_PRIVATE_KEY` for quote) |
-| `--from` | Yes | Wallet address (must match API Key binding) |
+| `--chain` | Yes | `sol` / `bsc` / `base` |
+| `--from` | Yes | Wallet address |
 | `--input-token` | Yes | Input token contract address |
 | `--output-token` | Yes | Output token contract address |
 | `--amount` | Yes | Input amount (smallest unit) |
-| `--slippage` | Yes | Slippage tolerance, e.g. `0.01` = 1% |
+| `--slippage` | Yes | Slippage tolerance as an integer 0–100, e.g. `30` = 30% |

 **Response fields (data):**

@@ -479,7 +527,7 @@ npx gmgn-cli swap \
 | `--output-token` | Yes | all | Output token contract address |
 | `--amount` | No* | all | Input raw amount in minimal unit (e.g., lamports for SOL); required unless `--percent` is used |
 | `--percent` | No* | all | Input amount as a percentage, e.g. `50` = 50%; required unless `--amount` is used; only valid when input token is not a currency (not SOL/BNB/ETH/USDC) |
-| `--slippage` | No | all | Slippage tolerance, e.g. `0.01` = 1% |
+| `--slippage` | No | all | Slippage tolerance as an integer 0–100, e.g. `30` = 30% |
 | `--auto-slippage` | No | all | Enable automatic slippage |
 | `--min-output` | No | all | Minimum output amount (raw amount) |
 | `--anti-mev` | No | all | Enable anti-MEV protection (default true) |
@@ -557,7 +605,7 @@ gmgn-cli multi-swap \
 | `--input-amount` | No* | all | JSON map `{"addr":"amount"}` in smallest unit; one of the three amount fields is required |
 | `--input-amount-bps` | No* | all | JSON map `{"addr":"bps"}` where 5000 = 50%; only valid when input token is not a currency |
 | `--output-amount` | No* | all | JSON map `{"addr":"amount"}` target output in smallest unit |
-| `--slippage` | No | all | Slippage tolerance, e.g. `0.01` = 1% |
+| `--slippage` | No | all | Slippage tolerance as an integer 0–100, e.g. `30` = 30% |
 | `--auto-slippage` | No | all | Enable automatic slippage |
 | `--anti-mev` | No | all | Enable anti-MEV protection |
 | `--priority-fee` | No | `sol` | Priority fee in SOL (≥ 0.00001) |
@@ -608,14 +656,17 @@ gmgn-cli order strategy create \
  --from <wallet_address> \
  --base-token <base_token_address> \
  --quote-token <quote_token_address> \
-  --order-type <limit_order> \
-  --sub-order-type <buy_low|buy_high|stop_loss|take_profit> \
-  --check-price <price> \
+  --order-type <limit_order|smart_trade> \
+  --sub-order-type <buy_low|buy_high|stop_loss|take_profit|mix_trade> \
+  [--check-price <price>] \
+  [--open-price <price>] \
  [--amount-in <amount> | --amount-in-percent <pct>] \
  [--slippage <n> | --auto-slippage] \
  [--limit-price-mode <exact|slippage>] \
  [--expire-in <seconds>] \
  [--sell-ratio-type <buy_amount|hold_amount>] \
+  [--quote-investment <amount>] \
+  [--condition-orders <json>] \
  [--priority-fee <sol>] \
  [--tip-fee <amount>] \
  [--gas-price <gwei>] \
@@ -625,19 +676,22 @@ gmgn-cli order strategy create \

 | Option | 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 |
-| `--order-type` | Yes | Order type: `limit_order` |
-| `--sub-order-type` | Yes | Sub-order type: `buy_low` / `buy_high` / `stop_loss` / `take_profit` |
-| `--check-price` | Yes | Trigger check price |
+| `--order-type` | Yes | Order type: `limit_order` / `smart_trade` |
+| `--sub-order-type` | Yes | `limit_order`: `buy_low` / `buy_high` / `stop_loss` / `take_profit`; `smart_trade` with condition_orders: `mix_trade` |
+| `--check-price` | No* | Trigger check price — required for `limit_order`; omit for `smart_trade` (trigger is in the `buy_low` condition order) |
+| `--open-price` | No | Open price of the position |
 | `--amount-in` | No* | Input amount (smallest unit); required unless `--amount-in-percent` is used |
 | `--amount-in-percent` | No* | Input as percentage (e.g. `50` = 50%); required unless `--amount-in` is used |
 | `--limit-price-mode` | No | `exact` / `slippage` (default: `slippage`) |
 | `--expire-in` | No | Order expiry in seconds |
 | `--sell-ratio-type` | No | `buy_amount` (default) / `hold_amount` |
-| `--slippage` | No | Slippage tolerance, e.g. `0.01` = 1% |
+| `--quote-investment` | No | Quote token investment amount (`smart_trade`) |
+| `--condition-orders` | No | JSON array of condition sub-orders for `smart_trade`. Must include one `buy_low` entry (with `check_price` lower than `open_price`) plus at least one TP/SL entry |
+| `--slippage` | No | Slippage tolerance as an integer 0–100, e.g. `30` = 30% |
 | `--auto-slippage` | No | Enable automatic slippage |
 | `--priority-fee` | No | Priority fee in SOL (**required for SOL chain**) |
 | `--tip-fee` | No | Tip fee (**required for SOL chain**) |
@@ -730,11 +784,10 @@ gmgn-cli cooking create \
  --buy-amt <amount> \
  [--image <base64> | --image-url <url>] \
  [--slippage <n> | --auto-slippage] \
-  [--description <text>] \
  [--website <url>] [--twitter <url>] [--telegram <url>] \
  [--fee <amount>] [--priority-fee <sol>] [--tip-fee <amount>] [--gas-price <amount>] \
  [--max-fee-per-gas <amount>] [--max-priority-fee-per-gas <amount>] \
-  [--anti-mev] [--anti-mev-mode <normal|secure>] \
+  [--anti-mev] [--anti-mev-mode <off|normal|secure>] \
  [--raised-token <symbol>] \
  [--dev-wallet-bps <n>] [--dev-gas <amount>] [--dev-priority <amount>] [--dev-tip <amount>] [--dev-max-fee-per-gas <amount>] \
  [--approve-vision <v1|v2>] [--source <source>] \
@@ -744,7 +797,7 @@ gmgn-cli cooking create \
  [--fourmeme-rate-conf <json>] \
  [--bags-fee-share-list <json>] \
  [--bonk-model <model>] \
-  [--buy-wallets <json>] [--snip-buy-wallets <json>] [--interval-seconds <n>] \
+  [--buy-wallets <json>] [--snip-buy-wallets <json>] \
  [--buy-trade-config <json>] [--sell-trade-config <json>] [--sell-configs <json>] \
  [--raw]
 ```
@@ -759,9 +812,8 @@ gmgn-cli cooking create \
 | `--buy-amt` | Yes | Initial buy amount in native token (e.g. `0.01` SOL) |
 | `--image` | No* | Token logo as base64-encoded data (max 2MB decoded); required unless `--image-url` is used |
 | `--image-url` | No* | Token logo URL; required unless `--image` is used |
-| `--slippage` | No* | Slippage tolerance, e.g. `0.01` = 1%; required unless `--auto-slippage` is used |
+| `--slippage` | No* | Slippage tolerance as an integer 0–100, e.g. `30` = 30%; required unless `--auto-slippage` is used |
 | `--auto-slippage` | No* | Enable automatic slippage; required unless `--slippage` is used |
-| `--description` | No | Token description / project pitch |
 | `--website` | No | Website URL |
 | `--twitter` | No | Twitter link |
 | `--telegram` | No | Telegram link |
@@ -772,7 +824,7 @@ gmgn-cli cooking create \
 | `--max-fee-per-gas` | No | Max fee per gas in wei (**EVM only**) |
 | `--max-priority-fee-per-gas` | No | Max priority fee per gas in wei (**EVM only**) |
 | `--anti-mev` | No | Enable anti-MEV protection (**SOL only**) |
-| `--anti-mev-mode` | No | Anti-MEV mode: `normal` / `secure` (**SOL only**) |
+| `--anti-mev-mode` | No | Anti-MEV mode: `off` / `normal` / `secure` (**SOL only**) |
 | `--raised-token` | No | Raise token symbol: `pump`→`USDC`; `bonk`→`USD1`; `fourmeme`→`USDT`/`USD1`; omit for native |
 | `--dev-wallet-bps` | No | Dev wallet fee share in basis points (100 = 1%) |
 | `--dev-gas` | No | Dev gas amount |
@@ -784,14 +836,13 @@ gmgn-cli cooking create \
 | `--is-mayhem` | No | Enable Mayhem mode (**Pump.fun only**) |
 | `--is-cashback` | No | Enable Cashback (**Pump.fun only**) |
 | `--is-buy-back` | No | Enable Agent Auto Buyback (**Pump.fun only**) |
-| `--pump-fee-share-list` | No | Fee share list as JSON array: `[{"provider":"github","username":"<handle>","basic_points":<n>}]` (**Pump.fun only**) |
+| `--pump-fee-share-list` | No | Fee share list as JSON array: `[{"provider":"twitter","username":"<handle>","basic_points":<n>}]` (**Pump.fun only**) |
 | `--flap-rate-conf` | No | Rate config as JSON object (**Flap only**) |
 | `--fourmeme-rate-conf` | No | Rate config as JSON object (**FourMeme only**) |
 | `--bags-fee-share-list` | No | Fee share list as JSON array: `[{"provider":"twitter","username":"<handle>","basic_points":<n>}]` (**BAGS only**) |
 | `--bonk-model` | No | Bonk model identifier (**bonk DEX only**) |
 | `--buy-wallets` | No | Multi-wallet buy config as JSON array: `[{"from_address":"<addr>","buy_amt":"<n>"}]` |
 | `--snip-buy-wallets` | No | Snipe-buy wallet config as JSON array: `[{"from_address":"<addr>","buy_amt":"<n>"}]` |
-| `--interval-seconds` | No | Interval between multi-wallet buys in seconds |
 | `--buy-trade-config` | No | Buy-side trade config for CondMarket orders as JSON (TradeParam) |
 | `--sell-trade-config` | No | Sell-side trade config for auto-sell / pending_sell as JSON (TradeParam) |
 | `--sell-configs` | No | Auto-sell strategy list as JSON array (CookingSellConfig[]): `[{"sell_type":"delay_sell","delay_sec":<n>,"sell_ratio":"0.5","wallet_addresses":["<addr>"]}]` |
@@ -1,12 +1,12 @@
 {
  "name": "gmgn-cli",
-  "version": "1.3.8",
+  "version": "1.4.7",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "gmgn-cli",
-      "version": "1.3.8",
+      "version": "1.4.7",
      "license": "MIT",
      "dependencies": {
        "commander": "^12.1.0",
@@ -1,6 +1,6 @@
 {
  "name": "gmgn-cli",
-  "version": "1.3.8",
+  "version": "1.4.7",
  "description": "GMGN OpenAPI CLI — call GMGN market, token, portfolio and swap APIs from the command line",
  "type": "module",
  "bin": {
@@ -28,7 +28,7 @@ Use the `gmgn-cli` tool to create a token on a launchpad platform or query token

 - **Signed auth** — `cooking create` requires both `GMGN_API_KEY` and `GMGN_PRIVATE_KEY`. The private key never leaves the machine — the CLI uses it only for local signing. `cooking stats` uses exist auth (API Key only).

- **Slippage** — The initial buy is executed as part of the same transaction as token creation. Slippage applies to that buy. Use `--slippage` (decimal, e.g. `0.01` = 1%) or `--auto-slippage`. One of the two is required when `--buy-amt` is set.
+- **Slippage** — The initial buy is executed as part of the same transaction as token creation. Slippage applies to that buy. Use `--slippage` (integer 0–100, e.g. `30` = 30%) or `--auto-slippage`. One of the two is required when `--buy-amt` is set.

 ## Financial Risk Notice

@@ -62,6 +62,16 @@ When the user names a platform colloquially (e.g. "pump.fun", "four.meme"), map

 **Anti-MEV** (`--anti-mev`) is only supported on `sol`. Passing it on `bsc` or `base` will return a 400 error.

+### Quote Token conversion (when `--raised-token` is set)
+
+`--buy-amt` is **always in native token units** (SOL / BNB / ETH), even when raising with a quote token like USDC / USD1 / USDT. If the user states the amount in the quote token, convert it to native yourself before passing it:
+
+```
+buy_amt_in_native = quote_amount × quote_price / native_price
+```
+
+This conversion applies to **`--buy-amt`, and the `buy_amt` field inside `--buy-wallets` and `--snip-buy-wallets`**. It does **not** apply to `--sell-configs` (`check_price` there is always a USD market cap, not a token amount). Round to the chain's native decimals. When `--raised-token` is empty/native, no conversion is needed.
+
 ## Prerequisites

 - `cooking stats`: Only `GMGN_API_KEY` required
@@ -138,7 +148,7 @@ gmgn-cli cooking stats [--raw]
 | `--buy-amt` | Yes | Initial buy amount in **human-readable native token units** (e.g. `0.01` = 0.01 SOL). This is NOT in smallest unit. |
 | `--image` | No* | Token logo as **base64-encoded** data (max 2MB decoded). Mutually exclusive with `--image-url`. One of the two is required. |
 | `--image-url` | No* | Token logo as a publicly accessible URL. Mutually exclusive with `--image`. One of the two is required. |
-| `--slippage` | No* | Slippage tolerance, e.g. `0.01` = 1%. **Mutually exclusive with `--auto-slippage`** — provide one or the other. |
+| `--slippage` | No* | Slippage tolerance as an integer 0–100, e.g. `30` = 30%. **Mutually exclusive with `--auto-slippage`** — provide one or the other. |
 | `--auto-slippage` | No* | Enable automatic slippage. **Mutually exclusive with `--slippage`.** |
 | `--description` | No | Token description / project pitch |
 | `--website` | No | Project website URL |
@@ -151,7 +161,7 @@ gmgn-cli cooking stats [--raw]
 | `--max-fee-per-gas` | No | Max fee per gas in wei (**EVM only**) |
 | `--max-priority-fee-per-gas` | No | Max priority fee per gas in wei (**EVM only**) |
 | `--anti-mev` | No | Enable anti-MEV protection (**SOL only**; rejected on BSC / BASE) |
-| `--anti-mev-mode` | No | Anti-MEV mode: `normal` / `secure` (**SOL only**) |
+| `--anti-mev-mode` | No | Anti-MEV mode: `off` / `normal` / `secure` (**SOL only**) |
 | `--raised-token` | No | Raise token symbol. `pump`: `USDC`; `bonk`: `USD1`; `fourmeme`: `USDT` / `USD1`; omit or `""` for native |
 | `--dev-wallet-bps` | No | Dev wallet fee share in basis points (100 = 1%) |
 | `--dev-gas` | No | Dev gas amount |
@@ -163,14 +173,13 @@ gmgn-cli cooking stats [--raw]
 | `--is-mayhem` | No | Enable Mayhem mode (**Pump.fun only**) |
 | `--is-cashback` | No | Enable Cashback (**Pump.fun only**) |
 | `--is-buy-back` | No | Enable Agent Auto Buyback (**Pump.fun only**) |
-| `--pump-fee-share-list` | No | Pump.fun fee share list as JSON array: `[{"provider":"github","username":"<handle>","basic_points":<n>}]` (**Pump.fun only**) |
+| `--pump-fee-share-list` | No | Pump.fun fee share list as JSON array: `[{"provider":"twitter","username":"<handle>","basic_points":<n>}]` (**Pump.fun only**) |
 | `--flap-rate-conf` | No | Flap rate config as JSON object (**Flap only**) |
 | `--fourmeme-rate-conf` | No | FourMeme rate config as JSON object (**FourMeme only**) |
 | `--bags-fee-share-list` | No | BAGS fee share list as JSON array: `[{"provider":"twitter","username":"<handle>","basic_points":<n>}]` (**BAGS only**) |
 | `--bonk-model` | No | Bonk model identifier (**bonk DEX only**) |
 | `--buy-wallets` | No | Multi-wallet buy config as JSON array: `[{"from_address":"<addr>","buy_amt":"<n>"}]` |
 | `--snip-buy-wallets` | No | Snipe-buy wallet config as JSON array: `[{"from_address":"<addr>","buy_amt":"<n>"}]` |
-| `--interval-seconds` | No | Interval between multi-wallet buys in seconds |
 | `--buy-trade-config` | No | Buy-side trade config for CondMarket orders as JSON (TradeParam) — see Advanced API Fields |
 | `--sell-trade-config` | No | Sell-side trade config for auto-sell / pending_sell as JSON (TradeParam) — see Advanced API Fields |
 | `--sell-configs` | No | Auto-sell strategy list as JSON array (CookingSellConfig[]) — see Auto-Sell Configuration |
@@ -181,6 +190,23 @@ gmgn-cli cooking stats [--raw]

 The structured flags (`--pump-fee-share-list`, `--bags-fee-share-list`, `--flap-rate-conf`, `--fourmeme-rate-conf`, `--buy-wallets`, `--snip-buy-wallets`, `--buy-trade-config`, `--sell-trade-config`, `--sell-configs`) each accept a **JSON string**. This section documents the exact JSON schema for each.

+### Platform capability matrix
+
+Which advanced features each platform supports. Do not send a field a platform does not support.
+
+| Platform | `--dex` | Chain | Platform-specific fields | Bundle (`--buy-wallets`) | Sniper (`--snip-buy-wallets`) | Cashback | Mayhem |
+|---|---|---|---|---|---|---|---|
+| Pump.fun | `pump` | SOL | `--pump-fee-share-list` / `--dev-wallet-bps` / `--is-buy-back` | ✅ up to 12 wallets | ✅ up to 10 | ✅ | ✅ |
+| Bonk | `bonk` | SOL | `--bonk-model` | ❌ | ✅ up to 10 | ❌ | ❌ |
+| BAGS | `bags` | SOL | `--bags-fee-share-list` / `--dev-wallet-bps` | ❌ | ✅ up to 10 | ❌ | ❌ |
+| FourMeme | `fourmeme` | BSC | `--fourmeme-rate-conf` | ✅ up to 3 wallets | ✅ up to 10 | ❌ | ❌ |
+| Flap | `flap` | BSC | `--flap-rate-conf` | ❌ | ✅ up to 10 | ❌ | ❌ |
+| Klik | `klik` | Base | — | ❌ | ✅ up to 10 | ❌ | ❌ |
+| Clanker | `clanker` | Base | — | ❌ | ✅ up to 10 | ❌ | ❌ |
+
+- `--is-cashback` / `--is-mayhem` are **Pump.fun only** — other platforms reject them.
+- Bundle/auto-sell (`--sell-configs`) and sniper (`--snip-buy-wallets`) are available where the matrix shows ✅.
+
 **Basis-points rule:** any field named `*_bps` / `basic_points` is in basis points (`100` = 1%). Where a section says the shares must sum, all entries must add up to exactly **10000** (FourMeme uses whole percents summing to **100** instead — see below).

 **Always talk to the user in percentages, never basis points.** When asking for or confirming any share, fee, or split, phrase it as a percentage (e.g. *"What % goes to this wallet?"* → user says `"50%"`). Convert to the field's unit yourself when building the JSON — never ask the user for a raw bps number:
@@ -206,11 +232,11 @@ Never set a fee-share split without the user's explicit instruction — it perma

 | Field | Type | Required | Description |
 |---|---|---|---|
-| `provider` | string | Yes | `github` / `wallet` |
-| `username` | string | Yes | Username for `github`; a SOL address when `wallet` |
+| `provider` | string | Yes | `solana` / `twitter` / `github` |
+| `username` | string | Yes | Platform username; a SOL address when `provider` = `solana` |
 | `basic_points` | int | Yes | Share in bps — all entries must sum to **10000** |

-Example: `--pump-fee-share-list '[{"provider":"github","username":"handle","basic_points":10000}]'`
+Example: `--pump-fee-share-list '[{"provider":"twitter","username":"handle","basic_points":10000}]'`

 ### Bonk (`--dex bonk`)

@@ -236,23 +262,25 @@ Example: `--pump-fee-share-list '[{"provider":"github","username":"handle","basi

 | Field | Type | Required | Description |
 |---|---|---|---|
-| `beneficiary` | string | Yes | Fee recipient address |
-| `tax_rate` | int | Conditional | V5 unified tax rate in bps, e.g. 5% → `500` |
-| `buy_tax_rate` | int | Conditional | V6 separate buy tax rate in bps |
+| `buy_tax_rate` | int | Conditional | V6 separate buy tax rate in bps, e.g. 1% → `100`. Use together with `sell_tax_rate`. |
 | `sell_tax_rate` | int | Conditional | V6 separate sell tax rate in bps |
-| `mkt_bps` | int | Yes | Marketing / donation fund share |
+| `tax_rate` | int | Conditional | V5 unified tax rate in bps, e.g. 5% → `500`. Use instead of `buy_tax_rate` + `sell_tax_rate`. |
+| `mkt_bps` | int | Yes | **Tax recipient share** — the slice of the collected tax routed to the recipient(s): the X handle when `recipient_type = gift`, or the `split_conf` addresses when `recipient_type = split`. This is NOT a generic "marketing" fund. |
 | `deflation_bps` | int | Yes | Burn (supply-reduction) share |
 | `dividend_bps` | int | Yes | Dividend (holder-reward) share |
 | `lp_bps` | int | Yes | Liquidity share |
+| `recipient_type` | string | Yes | `gift` (route the recipient share to an X handle) / `split` (route it to specific addresses) |
+| `twitter_account` | string | Conditional | X / Twitter handle that receives the recipient share — **required when `recipient_type = gift`**; leave `""` when `split`. |
+| `split_conf` | array | Conditional | Recipient address split list — **required when `recipient_type = split`**; leave `[]` when `gift`. |
 | `minimum_share_balance` | int | Yes | Min holding to qualify for dividends — minimum **10000** tokens |
-| `recipient_type` | string | Yes | `split` (proportional) / `gift` |
-| `twitter_account` | string | Yes | Twitter username |
-| `split_conf` | array | Yes | Split list — see below |
+| `beneficiary` | string | No | Legacy single fee-recipient address. Omit when using `recipient_type` + `twitter_account` / `split_conf`. |

 `split_conf` entries: `{ "recipient": "<address>", "bps": <n> }` — all `bps` must sum to **10000**.

+> - **Tax distribution:** whenever the tax rate > 0, `mkt_bps + deflation_bps + dividend_bps + lp_bps` must sum to **10000**. `mkt_bps` is the recipient's cut; the other three are burn / dividend / liquidity.
+> - **Recipient routing:** set `recipient_type = gift` + `twitter_account` to send the recipient cut to an X handle, OR `recipient_type = split` + `split_conf` to send it to one or more addresses. Fill only the field that matches the chosen mode; leave the other empty (`""` / `[]`).
 > - Use `tax_rate` for V5 (unified rate); use `buy_tax_rate` + `sell_tax_rate` for V6 (separate rates).
-> - When the tax rate > 0: `mkt_bps + deflation_bps + dividend_bps + lp_bps` must sum to **10000**. When `lp_bps > 0`: `minimum_share_balance` must be > 0.
+> - When `lp_bps > 0`: `minimum_share_balance` must be > 0.

 ### FourMeme (`--dex fourmeme`)

@@ -298,6 +326,29 @@ The buy/sell execution params for these CondMarket orders (slippage, fees, anti-
 > - `wallet_addresses` may mix `from_address` and `buy_wallets` entries. The server creates `signal_cooking` for snipe wallets and `pending_sell` for main/bundle wallets automatically.
 > - A wallet can carry multiple strategies (e.g. delay-sell 50%, then limit-sell the rest); each applies independently.

+### TradeParam (`--buy-trade-config` / `--sell-trade-config`)
+
+These tune the **execution params for the CondMarket buy/sell orders** (bundle buys, sniper buys, and auto-sell). They do **not** affect the main creation transaction (the dev tx uses the outer-level `--dev-*` flags). When omitted, they fall back to the outer-level transaction flags.
+
+`--buy-trade-config` / `--sell-trade-config` each accept a single JSON object:
+
+| Field | Type | Description |
+|---|---|---|
+| `slippage` | number | Slippage; only sent when truthy |
+| `fee` | string | Base gas / fee; only sent when truthy |
+| `priority_fee` | string | Priority fee; only sent when truthy |
+| `tip_fee` | string | SOL Jito tip; only sent when truthy |
+| `gas_price` | string | Gas price in wei (EVM); only sent when truthy |
+| `max_priority_fee_per_gas` | string | EVM EIP-1559; only sent when truthy |
+| `max_fee_per_gas` | string | EVM EIP-1559; only sent when truthy |
+| `auto_slippage` | bool | Always sent |
+| `is_anti_mev` | bool | Always sent |
+| `anti_mev_mode` | string | `off` / `normal` / `secure`; always sent |
+
+Example: `--buy-trade-config '{"slippage":50,"auto_slippage":false,"priority_fee":"0.0005","tip_fee":"0.0001","is_anti_mev":true,"anti_mev_mode":"secure"}'`
+
+> A standard launch with no `buyConfig` sends `{"is_anti_mev":false,"anti_mev_mode":"off"}` and an empty `buy_wallets` list.
+
 ## `cooking create` Response Fields

 | Field | Type | Description |
@@ -323,6 +374,8 @@ Token creation is **asynchronous**. If the initial `cooking create` response sho

 ## Usage Examples

+Examples run shortest-first: basic single-launch commands, then full end-to-end configurations. Every JSON flag below is a valid payload shape — copy and adapt.
+
 ```bash
 # Get token creation statistics per launchpad
 gmgn-cli cooking stats
@@ -336,7 +389,7 @@ gmgn-cli cooking create \
  --symbol MAT \
  --buy-amt 0.01 \
  --image-url https://example.com/logo.png \
-  --slippage 0.01 \
+  --slippage 30 \
  --priority-fee 0.001

 # Create a token on FourMeme (BSC) — base64 image + USD1 raise token
@@ -376,6 +429,99 @@ gmgn-cli cooking create \
  --sell-configs '[{"sell_type":"delay_sell","delay_sec":60,"sell_ratio":"0.5","wallet_addresses":["<wallet_address>"]}]'
 ```

+These mirror real launch configurations end-to-end.
+
+**Pump.fun (SOL) — Bundle + Sniper + Auto-Sell + Agent Auto Buyback**
+
+```bash
+gmgn-cli cooking create \
+  --chain sol \
+  --dex pump \
+  --from DevWallet... \
+  --name "Demo Coin" \
+  --symbol DEMO \
+  --buy-amt 0.5 \
+  --image-url https://cdn.example.com/coin.png \
+  --twitter https://x.com/handle/status/123 \
+  --priority-fee 0.0005 \
+  --tip-fee 0.0001 \
+  --is-buy-back \
+  --buy-trade-config '{"slippage":50,"auto_slippage":false,"priority_fee":"0.0005","tip_fee":"0.0001","is_anti_mev":true,"anti_mev_mode":"secure"}' \
+  --buy-wallets '[{"from_address":"Wallet1...","buy_amt":"0.1"},{"from_address":"Wallet2...","buy_amt":"0.1"}]' \
+  --snip-buy-wallets '[{"from_address":"Sniper1...","buy_amt":"0.05"}]' \
+  --sell-configs '[{"sell_type":"delay_sell","sell_ratio":"1","wallet_addresses":["Wallet1..."],"delay_mili_sec":5000}]'
+```
+
+- `--is-buy-back` is the Agent Auto Buyback mode (the backend also sets the agent fee internally).
+- `buy_amt` values in `--buy-wallets` / `--snip-buy-wallets` are in native SOL.
+- Bundle wallets ≤ 12, sniper wallets ≤ 10 on Pump.fun (see capability matrix).
+
+**FourMeme (BSC) — user fee split + raise token USDT**
+
+```bash
+gmgn-cli cooking create \
+  --chain bsc \
+  --dex fourmeme \
+  --from 0xDev... \
+  --name "Demo BSC" \
+  --symbol DBSC \
+  --buy-amt 0.0123 \
+  --image-url https://cdn.example.com/coin.png \
+  --raised-token USDT \
+  --website https://demo.com \
+  --gas-price 1000000000 \
+  --auto-slippage \
+  --fourmeme-rate-conf '{"fee_rate":1,"recipient_rate":50,"burn_rate":20,"divide_rate":20,"liquidity_rate":10,"min_sharing":100000,"recipient_address":"0xDev..."}'
+```
+
+- `--buy-amt 0.0123` is **already converted to native BNB** from the USDT amount the user wanted (see Quote Token conversion). Do the conversion before building the command.
+- `--gas-price 1000000000` is wei (1 Gwei).
+- In `--fourmeme-rate-conf`, `recipient_rate + burn_rate + divide_rate + liquidity_rate` must sum to **100**.
+
+**Flap (BSC) — `split` mode: route the recipient cut to a BSC address**
+
+```bash
+gmgn-cli cooking create \
+  --chain bsc \
+  --dex flap \
+  --from 0x1f8d977b6843e1bbcb306c4a3664c9fb0277979d \
+  --name "refer" \
+  --symbol refer \
+  --buy-amt 2 \
+  --image-url https://gmgn.ai/external-res-va/11ad7747dcefcfaae87d3f53a4d7330d_v2l.webp \
+  --website https://www.refercoins.bond/ \
+  --twitter https://x.com/referdotfun \
+  --dev-gas 50000000 \
+  --auto-slippage \
+  --flap-rate-conf '{"buy_tax_rate":100,"sell_tax_rate":100,"mkt_bps":10000,"deflation_bps":0,"dividend_bps":0,"lp_bps":0,"minimum_share_balance":10000,"recipient_type":"split","twitter_account":"","split_conf":[{"recipient":"0x1f8d977b6843e1bbcb306c4a3664c9fb0277979d","bps":10000}]}'
+```
+
+- `recipient_type: split` → the recipient cut goes to `split_conf` addresses; `twitter_account` is left `""`.
+- `mkt_bps:10000` means the **entire** tax (1% buy / 1% sell) goes to the recipient — `deflation_bps + dividend_bps + lp_bps` are all `0`, and the four still sum to **10000**.
+- `split_conf` has one address taking all `10000` bps (100%). Multiple addresses are allowed as long as their `bps` sum to `10000`.
+
+**Flap (BSC) — `gift` mode: route the recipient cut to an X handle, split the rest across burn / dividend / LP**
+
+```bash
+gmgn-cli cooking create \
+  --chain bsc \
+  --dex flap \
+  --from 0x1f8d977b6843e1bbcb306c4a3664c9fb0277979d \
+  --name "refer" \
+  --symbol refer \
+  --buy-amt 2 \
+  --image-url https://gmgn.ai/external-res-va/11ad7747dcefcfaae87d3f53a4d7330d_v2l.webp \
+  --website https://www.refercoins.bond/ \
+  --twitter https://x.com/referdotfun \
+  --dev-gas 50000000 \
+  --auto-slippage \
+  --flap-rate-conf '{"buy_tax_rate":100,"sell_tax_rate":100,"mkt_bps":5000,"deflation_bps":2700,"dividend_bps":1800,"lp_bps":500,"minimum_share_balance":10000,"recipient_type":"gift","twitter_account":"handleName","split_conf":[]}'
+```
+
+- `recipient_type: gift` → the recipient cut goes to the `twitter_account` X handle; `split_conf` is left `[]`.
+- Tax distribution: `mkt_bps:5000` (50% to the handle) + `deflation_bps:2700` (27% burn) + `dividend_bps:1800` (18% dividend) + `lp_bps:500` (5% LP) = **10000**.
+- `lp_bps > 0`, so `minimum_share_balance` must be > 0 (`10000` here).
+
 ## Output Format

 ### Pre-create Confirmation
@@ -86,11 +86,9 @@ 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 save it with `gmgn-cli config` (creates `~/.config/gmgn/.env` and sets `chmod 600` automatically — do not hand-edit the file):
   ```bash
-   mkdir -p ~/.config/gmgn
-   echo 'GMGN_API_KEY=<key_from_user>' > ~/.config/gmgn/.env
-   chmod 600 ~/.config/gmgn/.env
+   gmgn-cli config set-key <key_from_user>
   ```

 ## `market kline` Parameters
@@ -146,7 +144,7 @@ The response is an object with a `list` array. Each element in `list` is one can
 | `--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/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) |
+| `--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` / `four_xmode_agent` / `cubepeg` / `likwid` / `goplus_creator` / `goplus_skills` / `openfour` / `flap` / `flap_stocks` / `flap_aioracle` / `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

@@ -242,16 +240,20 @@ gmgn-cli market trending \
  --platform fourmeme --platform four_xmode_agent \
  --order-by volume --limit 50 --raw

-# BSC 5m hottest — fourmeme family, sorted by volume
+# BSC 5m hottest — all BSC launchpads, sorted by volume
 gmgn-cli market trending \
  --chain bsc --interval 5m \
  --platform fourmeme --platform fourmeme_agent --platform bn_fourmeme --platform four_xmode_agent \
+  --platform cubepeg --platform likwid --platform goplus_creator --platform goplus_skills --platform openfour \
+  --platform flap --platform flap_stocks --platform flap_aioracle --platform clanker --platform lunafun \
  --order-by volume --limit 50 --raw

-# BSC 1h trending — fourmeme with safety filters
+# BSC 1h trending — all BSC launchpads with safety filters
 gmgn-cli market trending \
  --chain bsc --interval 1h \
  --platform fourmeme --platform fourmeme_agent --platform bn_fourmeme --platform four_xmode_agent \
+  --platform cubepeg --platform likwid --platform goplus_creator --platform goplus_skills --platform openfour \
+  --platform flap --platform flap_stocks --platform flap_aioracle --platform clanker --platform lunafun \
  --filter not_honeypot --filter verified \
  --order-by volume --limit 20 --raw
 ```
@@ -745,25 +747,33 @@ gmgn-cli market trenches --chain sol --raw \
 # All three categories at once
 gmgn-cli market trenches --chain bsc --raw \
  --type new_creation --type near_completion --type completed \
-  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent --launchpad-platform flap --launchpad-platform clanker --launchpad-platform lunafun \
+  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent \
+  --launchpad-platform cubepeg --launchpad-platform likwid --launchpad-platform goplus_creator --launchpad-platform goplus_skills --launchpad-platform openfour \
+  --launchpad-platform flap --launchpad-platform flap_stocks --launchpad-platform flap_aioracle --launchpad-platform clanker --launchpad-platform lunafun \
  --limit 80

 # New creation only
 gmgn-cli market trenches --chain bsc --raw \
  --type new_creation \
-  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent --launchpad-platform flap --launchpad-platform clanker --launchpad-platform lunafun \
+  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent \
+  --launchpad-platform cubepeg --launchpad-platform likwid --launchpad-platform goplus_creator --launchpad-platform goplus_skills --launchpad-platform openfour \
+  --launchpad-platform flap --launchpad-platform flap_stocks --launchpad-platform flap_aioracle --launchpad-platform clanker --launchpad-platform lunafun \
  --limit 80

 # Near completion only
 gmgn-cli market trenches --chain bsc --raw \
  --type near_completion \
-  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent --launchpad-platform flap --launchpad-platform clanker --launchpad-platform lunafun \
+  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent \
+  --launchpad-platform cubepeg --launchpad-platform likwid --launchpad-platform goplus_creator --launchpad-platform goplus_skills --launchpad-platform openfour \
+  --launchpad-platform flap --launchpad-platform flap_stocks --launchpad-platform flap_aioracle --launchpad-platform clanker --launchpad-platform lunafun \
  --limit 80

 # Completed (open market) only
 gmgn-cli market trenches --chain bsc --raw \
  --type completed \
-  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent --launchpad-platform flap --launchpad-platform clanker --launchpad-platform lunafun \
+  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent \
+  --launchpad-platform cubepeg --launchpad-platform likwid --launchpad-platform goplus_creator --launchpad-platform goplus_skills --launchpad-platform openfour \
+  --launchpad-platform flap --launchpad-platform flap_stocks --launchpad-platform flap_aioracle --launchpad-platform clanker --launchpad-platform lunafun \
  --limit 80
 ```

@@ -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>] | [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> ...]"
+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|smart_trade> --sub-order-type <buy_low|buy_high|stop_loss|take_profit|mix_trade> ...]"
 metadata:
  cliHelp: "gmgn-cli swap --help"
 ---
@@ -12,13 +12,13 @@ metadata:

 **⚠️ IPv6 NOT SUPPORTED: If you get a `401` or `403` error and credentials look correct, check for IPv6 immediately: (1) list all network interfaces and their IPv6 addresses — run `ifconfig | grep inet6` (macOS) or `ip addr show | grep inet6` (Linux); (2) send a test request to `https://ipv6.icanhazip.com` — if the response is an IPv6 address, outbound traffic is going via IPv6. Tell the user immediately: "Please disable IPv6 on your network interface — gmgn-cli commands only work over IPv4."**

-Use the `gmgn-cli` tool to submit a token swap or query an existing order. `GMGN_API_KEY` is always required. `GMGN_PRIVATE_KEY` is required for critical-auth commands such as `swap` and all `order` subcommands, including `order quote`.
+Use the `gmgn-cli` tool to submit a token swap or query an existing order. `GMGN_API_KEY` is always required. `GMGN_PRIVATE_KEY` is required for critical-auth commands such as `swap` and `order` subcommands — except `order quote`, which only requires `GMGN_API_KEY`.

 ## Core Concepts

 - **Smallest unit** — `--amount` is always in the token's smallest indivisible unit, not human-readable amounts. For SOL: 1 SOL = 1,000,000,000 lamports. For EVM tokens: depends on decimals (most ERC-20 tokens use 18 decimals). Always convert before passing to the command — do not pass human amounts directly.

- **`slippage`** — Price tolerance expressed as a decimal, not a percentage. `0.01` = 1% slippage. `0.5` = 50% slippage. If the price moves beyond this threshold before the transaction confirms, the swap is rejected. Use `--auto-slippage` for volatile tokens to let GMGN set an appropriate value automatically.
+- **`slippage`** — Price tolerance as an integer 0–100, e.g. `30` = 30%. If the price moves beyond this threshold before the transaction confirms, the swap is rejected. Use `--auto-slippage` for volatile tokens to let GMGN set an appropriate value automatically.

 - **`--amount` vs `--percent`** — Mutually exclusive. `--amount` specifies an exact input quantity (in smallest unit). `--percent` sells a percentage of the current balance and is only valid when `input_token` is NOT a currency (SOL/BNB/ETH/USDC). Never use `--percent` to spend a fraction of SOL/BNB/ETH.

@@ -26,7 +26,7 @@ Use the `gmgn-cli` tool to submit a token swap or query an existing order. `GMGN

 - **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.**

- **Signed 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.
+- **Signed auth** — `swap` and most `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. Exception: `order quote` only requires `GMGN_API_KEY`.

 - **`order_id` / `status`** — After submitting a swap, the response includes an `order_id`. Use `order get --order-id` to poll for final status. Possible values: `pending` → `processed` → `confirmed` (success) or `failed` / `expired`. Do not report success until status is `confirmed`.

@@ -47,7 +47,7 @@ Use the `gmgn-cli` tool to submit a token swap or query an existing order. `GMGN
 |-------------|-------------|
 | `swap` | Submit a token swap |
 | `multi-swap` | Submit token swaps across multiple wallets concurrently (up to 100) |
-| `order quote` | Get a swap quote (no transaction submitted; requires signed auth) |
+| `order quote` | Get a swap quote (no transaction submitted; exist auth — API Key only, no private key needed) |
 | `order get` | Query order status |
 | `gas-price` | Query recommended gas price (low / average / high tiers) for any chain; exist auth (API Key only) |
 | `order strategy create` | Create a limit/strategy order (requires private key) |
@@ -74,7 +74,7 @@ Currency tokens are the base/native assets of each chain. They are used to buy o

 ## Prerequisites

-`GMGN_API_KEY` must be configured in `~/.config/gmgn/.env`. `GMGN_PRIVATE_KEY` is additionally required for `swap` and all `order` subcommands. The private key must correspond to the wallet bound to the API Key.
+`GMGN_API_KEY` must be configured in `~/.config/gmgn/.env`. `GMGN_PRIVATE_KEY` is additionally required for `swap` and `order` subcommands other than `order quote`. The private key must correspond to the wallet bound to the API Key.

 - `gmgn-cli` installed globally — if missing, run: `npm install -g gmgn-cli`

@@ -145,7 +145,7 @@ gmgn-cli swap \
  --input-token <input_token_address> \
  --output-token <output_token_address> \
  --amount 1000000 \
-  --slippage 0.01
+  --slippage 30

 # With automatic slippage
 gmgn-cli swap \
@@ -184,7 +184,7 @@ gmgn-cli swap \
 | `--output-token` | Yes | all | Output token contract address |
 | `--amount` | No* | all | Input amount in smallest unit. **Mutually exclusive with `--percent`** — provide one or the other, never both. Required unless `--percent` is used. |
 | `--percent <pct>` | No* | all | Sell percentage of `input_token`, e.g. `50` = 50%, `1` = 1%. Sets `input_amount` to `0` automatically. **Mutually exclusive with `--amount`. Only valid when `input_token` is NOT a currency (SOL/BNB/ETH/USDC).** |
-| `--slippage <n>` | No | all | Slippage tolerance, e.g. `0.01` = 1%. **Mutually exclusive with `--auto-slippage`** — use one or the other. |
+| `--slippage <n>` | No | all | Slippage tolerance as an integer 0–100, e.g. `30` = 30%. **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 | sol / bsc / eth | Enable anti-MEV protection — **recommended**; protects against frontrunning and sandwich attacks. Default: on. **Not supported on `base`.** |
@@ -228,7 +228,7 @@ gmgn-cli swap \
  --input-token So11111111111111111111111111111111111111112 \
  --output-token <token_A_address> \
  --amount 10000000 \
-  --slippage 0.3 \
+  --slippage 30 \
  --anti-mev \
  --condition-orders '[{"order_type":"profit_stop","side":"sell","price_scale":"100","sell_ratio":"50"},{"order_type":"profit_stop","side":"sell","price_scale":"300","sell_ratio":"100"},{"order_type":"loss_stop","side":"sell","price_scale":"65","sell_ratio":"100"}]' \
  --sell-ratio-type hold_amount
@@ -246,7 +246,7 @@ gmgn-cli swap \
  --input-token So11111111111111111111111111111111111111112 \
  --output-token <token_A_address> \
  --amount 10000000 \
-  --slippage 0.3 \
+  --slippage 30 \
  --anti-mev \
  --condition-orders '[{"order_type":"profit_stop","side":"sell","price_scale":"100","sell_ratio":"50"},{"order_type":"profit_stop","side":"sell","price_scale":"300","sell_ratio":"50"},{"order_type":"loss_stop","side":"sell","price_scale":"65","sell_ratio":"100"}]' \
  --sell-ratio-type buy_amount
@@ -358,7 +358,7 @@ gmgn-cli multi-swap \
  --input-token <input_token_address> \
  --output-token <output_token_address> \
  --input-amount '{"<addr1>":"1000000","<addr2>":"2000000"}' \
-  --slippage 0.01
+  --slippage 30

 # Sell a percentage of each wallet's balance (use --input-amount-bps)
 gmgn-cli multi-swap \
@@ -367,7 +367,7 @@ gmgn-cli multi-swap \
  --input-token <token_address> \
  --output-token <sol_address> \
  --input-amount-bps '{"<addr1>":"5000","<addr2>":"10000"}' \
-  --slippage 0.01
+  --slippage 30

 # With per-wallet take-profit / stop-loss (condition_orders)
 gmgn-cli multi-swap \
@@ -376,7 +376,7 @@ gmgn-cli multi-swap \
  --input-token So11111111111111111111111111111111111111112 \
  --output-token <token_address> \
  --input-amount '{"<addr1>":"1000000","<addr2>":"2000000"}' \
-  --slippage 0.3 \
+  --slippage 30 \
  --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"}]'
@@ -388,7 +388,7 @@ gmgn-cli multi-swap \
  --input-token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
  --output-token <token_address> \
  --input-amount '{"<0xaddr1>":"1000000","<0xaddr2>":"2000000"}' \
-  --slippage 0.01 \
+  --slippage 30 \
  --gas-price 5
 ```

@@ -403,7 +403,7 @@ gmgn-cli multi-swap \
 | `--input-amount` | No* | all | JSON map of `wallet_address → input amount` (smallest unit). One of `--input-amount`, `--input-amount-bps`, or `--output-amount` is required. |
 | `--input-amount-bps` | No* | all | JSON map of `wallet_address → percent in bps` (1–10000; 5000 = 50%). Only valid when `input_token` is NOT a currency. |
 | `--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`. |
+| `--slippage <n>` | No | all | Slippage tolerance as an integer 0–100, e.g. `30` = 30%. Mutually exclusive with `--auto-slippage`. |
 | `--auto-slippage` | No | all | Enable automatic slippage. |
 | `--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. |
@@ -433,7 +433,7 @@ The response `data` is an array — one element per wallet:

 ## `order quote` Usage

-Get an estimated output amount before submitting a swap. All supported quote chains use signed auth and require `GMGN_PRIVATE_KEY`.
+Get an estimated output amount before submitting a swap. Uses normal auth — only `GMGN_API_KEY` required, no `GMGN_PRIVATE_KEY` needed.

 ```bash
 gmgn-cli order quote \
@@ -442,7 +442,7 @@ gmgn-cli order quote \
  --input-token <input_token_address> \
  --output-token <output_token_address> \
  --amount <input_amount_smallest_unit> \
-  --slippage 0.01
+  --slippage 30
 ```

 ### `order quote` Response Fields
@@ -512,7 +512,7 @@ All fields are omitempty — fields unsupported by a chain are omitted. Units ar
 ## `order strategy create` Usage

 ```bash
-# Create a take-profit order: sell when price rises to target
+# Create a take-profit order: sell when price rises to target (limit_order)
 gmgn-cli order strategy create \
  --chain sol \
  --from <wallet_address> \
@@ -522,9 +522,9 @@ gmgn-cli order strategy create \
  --sub-order-type take_profit \
  --check-price 0.002 \
  --amount-in 1000000 \
-  --slippage 0.01
+  --slippage 30

-# Create a stop-loss order: sell when price drops to target
+# Create a stop-loss order: sell when price drops to target (limit_order)
 gmgn-cli order strategy create \
  --chain sol \
  --from <wallet_address> \
@@ -534,7 +534,21 @@ gmgn-cli order strategy create \
  --sub-order-type stop_loss \
  --check-price 0.0005 \
  --amount-in-percent 100 \
-  --slippage 0.01
+  --slippage 30
+
+# Create a smart_trade with buy_low entry + take-profit + stop-loss (smart_trade)
+gmgn-cli order strategy create \
+  --chain sol \
+  --from <wallet_address> \
+  --base-token <token_address> \
+  --quote-token <sol_address> \
+  --order-type smart_trade \
+  --sub-order-type mix_trade \
+  --open-price 0.000082 \
+  --amount-in 1000000 \
+  --slippage 30 \
+  --sell-param '{"slippage":30,"priority_fee":"0.00001","tip_fee":"0.00001"}' \
+  --condition-orders '[{"order_type":"buy_low","side":"buy","check_price":"0.00008"},{"order_type":"profit_stop","side":"sell","price_scale":"100","sell_ratio":"50"},{"order_type":"loss_stop","side":"sell","price_scale":"50","sell_ratio":"100"}]'
 ```

 ## `order strategy create` Parameters
@@ -545,15 +559,19 @@ gmgn-cli order strategy create \
 | `--from` | Yes | all | Wallet address (must match API Key binding) |
 | `--base-token` | Yes | all | Base token contract address |
 | `--quote-token` | Yes | all | Quote token contract address |
-| `--order-type` | Yes | all | Order type: `limit_order` |
-| `--sub-order-type` | Yes | all | Sub-order type: `buy_low` / `buy_high` / `stop_loss` / `take_profit` |
-| `--check-price` | Yes | all | Trigger price in USD — the order fires when the token's USD price crosses this value |
+| `--order-type` | Yes | all | Order type: `limit_order` / `smart_trade` |
+| `--sub-order-type` | Yes | all | `limit_order`: `buy_low` / `buy_high` / `stop_loss` / `take_profit`; `smart_trade` with condition_orders: `mix_trade` |
+| `--check-price` | No* | all | Trigger price — required for `limit_order`; omit for `smart_trade` (trigger is in the `buy_low` condition order) |
+| `--open-price` | No | all | Open price of the position |
 | `--amount-in` | No* | all | Input amount (smallest unit). Mutually exclusive with `--amount-in-percent` |
 | `--amount-in-percent` | No* | all | Input as percentage (e.g. `50` = 50%). Mutually exclusive with `--amount-in` |
 | `--limit-price-mode` | No | all | `exact` / `slippage` (default: `slippage`) |
 | `--expire-in` | No | all | Order expiry in seconds |
 | `--sell-ratio-type` | No | all | `buy_amount` (default) — when triggered, sells a fixed token amount stored at strategy creation time; `hold_amount` — when triggered, sells a fixed percentage of the position held at trigger time |
-| `--slippage` | No | all | Slippage tolerance, e.g. `0.01` = 1%. Mutually exclusive with `--auto-slippage` |
+| `--quote-investment` | No | all | Quote token investment amount (`smart_trade`) |
+| `--sell-param` | Yes (`smart_trade`) | all | JSON object of sell-side trade params (slippage, fee, gas, etc.) used when a TP/SL condition fires. **Required for `smart_trade`.** Same fields as the root TradeParam; `slippage` is 0–100 integer. |
+| `--buy-param` | No | all | JSON object of buy-side trade params override for `smart_trade`. Same fields as root TradeParam; `slippage` is 0–100 integer. |
+| `--slippage` | No | all | Slippage tolerance as an integer 0–100, e.g. `30` = 30%. Mutually exclusive with `--auto-slippage`. Defaults to auto-slippage if neither is set. |
 | `--auto-slippage` | No | all | Enable automatic slippage |
 | `--priority-fee` | No | `sol` | Priority fee in SOL (≥ 0.00001). **Required** for SOL. |
 | `--tip-fee` | No | `sol` / `bsc` | Tip fee (SOL ≥ 0.00001 / BSC ≥ 0.000001 BNB). **Required** for SOL. |
@@ -563,6 +581,7 @@ gmgn-cli order strategy create \
 | `--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 | sol / bsc / eth | Enable anti-MEV protection. Not supported on `base`. |
+| `--condition-orders` | No | all | JSON array of condition sub-orders for `smart_trade`. Must include one `buy_low` entry (with `check_price` lower than `open_price`) plus at least one TP/SL entry. |

 ### `order strategy create` Response Fields

@@ -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>]"
+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. Also query which tokens a wallet has followed (bookmarked) on GMGN. Use when user asks what smart money or KOLs are buying, wants whale alerts, on-chain alpha, copy-trade signals, or wants to check a wallet's followed tokens. (For a specific wallet address's portfolio, use gmgn-portfolio.)
+argument-hint: "<follow-tokens|follow-wallet|kol|smartmoney> --chain <sol|bsc|base|eth> [--wallet <wallet_address>]"
 metadata:
  cliHelp: "gmgn-cli track --help"
 ---
@@ -49,6 +49,8 @@ Use the `gmgn-cli` tool to query on-chain tracking data based on the user's requ

 | Sub-command | Description |
 |-------------|-------------|
+| `track follow-tokens` | Followed token list for a wallet — which tokens a wallet has bookmarked on GMGN, with full market data |
+| `track follow-token-groups` | Follow token group names for a wallet — the group names and IDs the wallet uses to organise followed tokens |
 | `track follow-wallet` | Trade records from wallets the user personally follows on GMGN |
 | `track kol` | Real-time trades from KOL / influencer wallets tagged by GMGN |
 | `track smartmoney` | Real-time trades from smart money / whale wallets tagged by GMGN |
@@ -61,7 +63,7 @@ Use the `gmgn-cli` tool to query on-chain tracking data based on the user's requ

 - `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
- `GMGN_PRIVATE_KEY` — required for `track follow-wallet` only (signed auth); not needed for `kol` or `smartmoney`
+- `GMGN_PRIVATE_KEY` — required for `track follow-wallet` only (signed auth); not needed for `follow-tokens`, `kol`, or `smartmoney`

 ## Rate Limit Handling

@@ -69,6 +71,8 @@ All tracking routes used by this skill go through GMGN's leaky-bucket limiter wi

 | Command | Route | Weight |
 |---------|-------|--------|
+| `track follow-tokens` | `GET /v1/user/follow_tokens` | 3 |
+| `track follow-token-groups` | `GET /v1/user/follow_token_groups` | 1 |
 | `track follow-wallet` | `GET /v1/trade/follow_wallet` | 3 |
 | `track kol` | `GET /v1/user/kol` | 1 |
 | `track smartmoney` | `GET /v1/user/smartmoney` | 1 |
@@ -101,6 +105,18 @@ When a request returns `429`:
 ## Usage Examples

 ```bash
+# Followed token list for a wallet on SOL
+gmgn-cli track follow-tokens --chain sol --wallet <wallet_address>
+
+# Followed token list on BSC, raw JSON output
+gmgn-cli track follow-tokens --chain bsc --wallet <wallet_address> --raw
+
+# Follow token group names for a wallet on SOL
+gmgn-cli track follow-token-groups --chain sol --wallet <wallet_address>
+
+# Follow token group names, raw JSON output
+gmgn-cli track follow-token-groups --chain sol --wallet <wallet_address> --raw
+
 # Follow-wallet trades (all wallets you follow)
 gmgn-cli track follow-wallet --chain sol

@@ -126,6 +142,66 @@ gmgn-cli track smartmoney --limit 10 --raw
 gmgn-cli track smartmoney --chain sol --side sell --limit 10 --raw
 ```

+## `track follow-tokens` Options
+
+| Option | Description |
+|--------|-------------|
+| `--chain` | Required. `sol` / `bsc` / `base` / `eth` |
+| `--wallet <address>` | Required. Wallet address to query |
+| `--group-id <id>` | Filter by group: `all_group` (all tokens across groups), `default` (default group), or a user-defined group ID |
+| `--interval <interval>` | Time interval for price change stats (e.g. `1m`, `5m`, `1h`, `6h`, `24h`) |
+| `--order-by <field>` | Sort field: `created_at` / `swaps` / `volume` / `market_cap` / `liquidity` / `price` / `open_timestamp` |
+| `--direction <dir>` | Required when `--order-by` is set. `asc` / `desc` |
+| `--limit <n>` | Page size |
+| `--cursor <cursor>` | Pagination cursor from previous response |
+| `--search <text>` | Search by token name or address |
+
+## `track follow-tokens` Response Fields
+
+Top-level fields:
+
+| Field | Description |
+|-------|-------------|
+| `cursor` | Opaque cursor for fetching the next page |
+| `all_following` | Total number of followed tokens |
+| `is_recommend` | Whether results include recommended tokens |
+| `followings` | Array of followed token objects |
+
+Each item in `followings` contains:
+
+| Field | Description |
+|-------|-------------|
+| `address` | Token contract address |
+| `symbol` | Token ticker symbol |
+| `name` | Token name |
+| `chain` | Chain the token is on |
+| `price` | Current token price |
+| `price_change_percent` | Price change percentage |
+| `volume` | Trading volume |
+| `liquidity` | Pool liquidity |
+| `market_cap` | Market cap |
+| `swaps` | Total swaps |
+| `group_ids` | Follow groups this token belongs to |
+| `open_timestamp` | Unix timestamp when trading opened |
+
+## `track follow-token-groups` Options
+
+| Option | Description |
+|--------|-------------|
+| `--chain` | Required. `sol` / `bsc` / `base` / `eth` |
+| `--wallet <address>` | Required. Wallet address to query |
+
+## `track follow-token-groups` Response Fields
+
+`data` is an array. Each item contains:
+
+| Field | Description |
+|-------|-------------|
+| `chain` | Chain the group is on |
+| `group_id` | Group identifier (e.g. `default`, or a user-defined ID) |
+| `group_name` | Human-readable group name |
+| `rank` | Display order / sort rank |
+
 ## `track follow-wallet` Options

 | Option | Description |
@@ -311,6 +387,7 @@ To research any token surfaced by smart money activity, follow [`docs/workflow-t

 ## Notes

+- `track follow-tokens` uses exist auth (API Key only); `--wallet` is required
 - `track follow-wallet` uses signed auth (API Key + private key signature); `track kol` and `track smartmoney` use exist 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
@@ -6,11 +6,16 @@
 *   Signed (swap and order routes): X-APIKEY + timestamp + client_id + X-Signature (private key signature)
 */

+import { createRequire } from "node:module";
+
 import { buildAuthQuery, buildMessage, detectAlgorithm, sign } from "./signer.js";

 const RATE_LIMIT_RETRY_BUFFER_MS = 1000;
 const DEFAULT_RATE_LIMIT_AUTO_RETRY_MAX_WAIT_MS = 5000;

+const { version: CLI_VERSION } = createRequire(import.meta.url)("../../package.json") as { version: string };
+const USER_AGENT = `gmgn-cli/${CLI_VERSION}`;
+
 interface PreparedRequest {
  method: string;
  subPath: string;
@@ -127,7 +132,7 @@ export interface StrategyCreateParams {
  quote_token: string;
  order_type: string;
  sub_order_type: string;
-  check_price: string;
+  check_price?: string;
  open_price?: string;
  amount_in?: string;
  amount_in_percent?: string;
@@ -148,6 +153,10 @@ export interface StrategyCreateParams {
  priority_fee?: string;
  tip_fee?: string;
  custom_rpc?: string;
+  condition_orders?: StrategyConditionOrder[];
+  quote_investment?: string;
+  sell_param?: TradeParam;
+  buy_param?: TradeParam;
 }

 export interface StrategyCancelParams {
@@ -171,8 +180,8 @@ export interface TokenSignalGroup {
 }

 export interface PumpFeeShareInfo {
-  provider: string;       // "github" | "wallet"
-  username: string;       // username for github; a SOL address when wallet
+  provider: string;       // "solana" | "twitter" | "github"
+  username: string;       // platform username; a SOL address when provider = "solana"
  basic_points: number;
 }

@@ -310,7 +319,6 @@ export interface CreateTokenParams {
  // Multi-wallet buy
  buy_wallets?: BuyWalletInfo[];
  snip_buy_wallets?: BuyWalletInfo[];
-  interval_seconds?: number;
 }

 export class OpenApiClient {
@@ -432,6 +440,14 @@ export class OpenApiClient {
    return this.authSignedRequest("GET", "/v1/trade/follow_wallet", { chain, ...extra }, null);
  }

+  async getFollowTokens(chain: string, walletAddress: string, extra: Record<string, string | number> = {}): Promise<unknown> {
+    return this.authExistRequest("GET", "/v1/user/follow_tokens", { chain, wallet_address: walletAddress, ...extra });
+  }
+
+  async getFollowGroupNames(chain: string, walletAddress: string): Promise<unknown> {
+    return this.authExistRequest("GET", "/v1/user/follow_token_groups", { chain, wallet_address: walletAddress });
+  }
+
  async getKol(chain?: string, limit?: number): Promise<unknown> {
    const query: Record<string, string | number> = {};
    if (chain) query["chain"] = chain;
@@ -459,7 +475,7 @@ export class OpenApiClient {
    slippage: number
  ): Promise<unknown> {
    const query = { chain, from_address, input_token, output_token, input_amount, slippage };
-    return this.authSignedRequest("GET", "/v1/trade/quote", query, null);
+    return this.authExistRequest("GET", "/v1/trade/quote", query);
  }

  // ---- Swap endpoints (signed auth) ----
@@ -519,6 +535,7 @@ export class OpenApiClient {
      const headers: Record<string, string> = {
        "X-APIKEY": this.apiKey,
        "Content-Type": "application/json",
+        "User-Agent": USER_AGENT,
      };
      const bodyStr = body !== null ? JSON.stringify(body) : null;
      return {
@@ -554,6 +571,7 @@ export class OpenApiClient {
        "X-APIKEY": this.apiKey,
        "X-Signature": signature,
        "Content-Type": "application/json",
+        "User-Agent": USER_AGENT,
      };
      return {
        method,
@@ -795,7 +813,8 @@ const TRENCHES_PLATFORMS: Record<string, string[]> = {
  ],
  bsc: [
    "fourmeme", "fourmeme_agent", "bn_fourmeme", "four_xmode_agent",
-    "flap", "clanker", "lunafun",
+    "cubepeg", "likwid", "goplus_creator", "goplus_skills", "openfour",
+    "flap", "flap_stocks", "flap_aioracle", "clanker", "lunafun",
  ],
  base: [
    "clanker", "bankr", "flaunch", "zora", "zora_creator",
@@ -32,7 +32,7 @@ export function registerCookingCommands(program: Command): void {
    .option("--website <url>", "Website URL")
    .option("--twitter <url>", "Twitter link")
    .option("--telegram <url>", "Telegram link")
-    .option("--slippage <n>", "Slippage tolerance (e.g. 0.01 = 1%)", parseFloat)
+    .option("--slippage <n>", "Slippage tolerance (e.g. 30 = 30%)", parseFloat)
    .option("--auto-slippage", "Enable automatic slippage")
    .option("--fee <amount>", "Base gas / fee")
    .option("--priority-fee <sol>", "Priority fee in SOL (SOL only)")
@@ -41,7 +41,7 @@ export function registerCookingCommands(program: Command): void {
    .option("--max-fee-per-gas <amount>", "Max fee per gas in wei (EVM only)")
    .option("--max-priority-fee-per-gas <amount>", "Max priority fee per gas in wei (EVM only)")
    .option("--anti-mev", "Enable anti-MEV protection (SOL only)")
-    .option("--anti-mev-mode <mode>", "Anti-MEV mode: normal / secure (SOL only)")
+    .option("--anti-mev-mode <mode>", "Anti-MEV mode: off / normal / secure (SOL only)")
    .option("--raised-token <symbol>", "Raise token symbol: pump→USDC; bonk→USD1; fourmeme→USDT/USD1; leave empty for native")
    .option("--dev-wallet-bps <n>", "Dev wallet fee in basis points (100 = 1%)", parseInt)
    .option("--dev-gas <amount>", "Dev gas amount")
@@ -66,7 +66,6 @@ export function registerCookingCommands(program: Command): void {
    // Multi-wallet buy
    .option("--buy-wallets <json>", "Multi-wallet buy config as JSON array [{from_address, buy_amt}]")
    .option("--snip-buy-wallets <json>", "Snipe-buy wallet config as JSON array [{from_address, buy_amt}]")
-    .option("--interval-seconds <n>", "Interval between multi-wallet buys in seconds", parseInt)
    // CondMarket execution config + auto-sell (JSON)
    .option("--buy-trade-config <json>", "Buy-side trade config for CondMarket orders as JSON (TradeParam)")
    .option("--sell-trade-config <json>", "Sell-side trade config for auto-sell / pending_sell as JSON (TradeParam)")
@@ -124,7 +123,6 @@ export function registerCookingCommands(program: Command): void {
      if (opts.bonkModel) params.bonk_model = opts.bonkModel;
      if (opts.buyWallets) params.buy_wallets = JSON.parse(opts.buyWallets);
      if (opts.snipBuyWallets) params.snip_buy_wallets = JSON.parse(opts.snipBuyWallets);
-      if (opts.intervalSeconds != null) params.interval_seconds = opts.intervalSeconds;
      if (opts.buyTradeConfig) params.buy_trade_config = JSON.parse(opts.buyTradeConfig);
      if (opts.sellTradeConfig) params.sell_trade_config = JSON.parse(opts.sellTradeConfig);
      if (opts.sellConfigs) params.sell_configs = JSON.parse(opts.sellConfigs);
@@ -57,7 +57,7 @@ export function registerMarketCommands(program: Command): void {
    .option("--order-by <field>", "Sort field: default / volume / swaps / marketcap / holder_count / price / change1h / ... (see docs for full list)")
    .option("--direction <dir>", "Sort direction: asc / desc")
    .option("--filter <tag...>", "Filter tags, repeatable. sol: renounced / frozen / has_social / not_wash_trading / ... evm: not_honeypot / verified / renounced / locked / ... (see docs for full list)")
-    .option("--platform <name...>", "Platform filter, repeatable. sol: Pump.fun / letsbonk / moonshot_app / ... bsc: fourmeme / flap / clanker / ... base: clanker / flaunch / zora / ... (see docs for full list)")
+    .option("--platform <name...>", "Platform filter, repeatable. sol: Pump.fun / letsbonk / moonshot_app / ... bsc: fourmeme / four_xmode_agent / cubepeg / likwid / goplus_creator / goplus_skills / openfour / flap / flap_stocks / flap_aioracle / clanker / ... base: clanker / flaunch / zora / ... (see docs for full list)")
    .option("--raw", "Output raw JSON")
    .action(async (opts) => {
      validateChain(opts.chain);
@@ -14,7 +14,7 @@ export function registerSwapCommands(program: Command): void {
    .requiredOption("--output-token <address>", "Output token contract address")
    .option("--amount <amount>", "Input raw amount (smallest unit)")
    .option("--percent <pct>", "Input amount as a percentage, e.g. 50 = 50%, 1 = 1%; only valid when input_token is NOT a currency", parseFloat)
-    .option("--slippage <n>", "Slippage tolerance (e.g. 0.01 = 1%)", parseFloat)
+    .option("--slippage <n>", "Slippage tolerance (e.g. 30 = 30%)", parseFloat)
    .option("--auto-slippage", "Enable automatic slippage")
    .option("--min-output <amount>", "Minimum output amount")
    .option("--anti-mev", "Enable anti-MEV protection, default true")
@@ -83,7 +83,7 @@ export function registerSwapCommands(program: Command): void {
    .option("--input-amount <json>", 'JSON map of wallet→amount (smallest unit), e.g. \'{"addr1":"1000000","addr2":"2000000"}\'')
    .option("--input-amount-bps <json>", 'JSON map of wallet→percent in bps (1–10000, e.g. 5000=50%), e.g. \'{"addr1":"5000"}\'')
    .option("--output-amount <json>", "JSON map of wallet→target output amount")
-    .option("--slippage <n>", "Slippage tolerance (e.g. 0.01 = 1%)", parseFloat)
+    .option("--slippage <n>", "Slippage tolerance (e.g. 30 = 30%)", parseFloat)
    .option("--auto-slippage", "Enable automatic slippage")
    .option("--anti-mev", "Enable anti-MEV protection")
    .option("--priority-fee <sol>", "Priority fee in SOL (SOL only, ≥ 0.00001)")
@@ -149,13 +149,13 @@ export function registerSwapCommands(program: Command): void {

  order
    .command("quote")
-    .description("Get a swap quote without submitting a transaction (signed auth — 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)")
+    .description("Get a swap quote without submitting a transaction (exist auth — GMGN_API_KEY only, no private key needed)")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
+    .requiredOption("--from <address>", "Wallet address")
    .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)
+    .requiredOption("--slippage <n>", "Slippage tolerance (e.g. 30 = 30%)", parseFloat)
    .option("--raw", "Output raw JSON")
    .action(async (opts) => {
      validateChain(opts.chain);
@@ -203,15 +203,17 @@ export function registerSwapCommands(program: Command): void {
    .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")
-    .requiredOption("--order-type <type>", "Order type: limit_order")
-    .requiredOption("--sub-order-type <type>", "Sub-order type: buy_low / buy_high / stop_loss / take_profit")
-    .requiredOption("--check-price <price>", "Trigger check price")
+    .requiredOption("--order-type <type>", "Order type: limit_order / smart_trade")
+    .requiredOption("--sub-order-type <type>", "Sub-order type: buy_low / buy_high / stop_loss / take_profit (limit_order); mix_trade (smart_trade with condition_orders)")
+    .option("--check-price <price>", "Trigger check price (required for limit_order; omit for smart_trade)")
+    .option("--open-price <price>", "Open price of the position")
    .option("--amount-in <amount>", "Input amount (smallest unit)")
    .option("--amount-in-percent <pct>", "Input amount as a percentage (e.g. 50 = 50%)")
    .option("--limit-price-mode <mode>", "Price mode: exact / slippage (default: slippage)")
    .option("--expire-in <seconds>", "Order expiry in seconds", parseInt)
    .option("--sell-ratio-type <type>", "Sell ratio basis: buy_amount (default) / hold_amount")
-    .option("--slippage <n>", "Slippage tolerance (e.g. 0.01 = 1%)", parseFloat)
+    .option("--quote-investment <amount>", "Quote token investment amount (smart_trade)")
+    .option("--slippage <n>", "Slippage tolerance (e.g. 30 = 30%)", parseFloat)
    .option("--auto-slippage", "Enable automatic slippage")
    .option("--priority-fee <sol>", "Priority fee in SOL (required for SOL chain)")
    .option("--tip-fee <amount>", "Tip fee (required for SOL chain)")
@@ -221,6 +223,9 @@ export function registerSwapCommands(program: Command): void {
    .option("--max-fee-per-gas <amount>", "EIP-1559 max fee per gas (BSC / BASE / ETH)")
    .option("--max-priority-fee-per-gas <amount>", "EIP-1559 max priority fee per gas (BSC / BASE / ETH)")
    .option("--anti-mev", "Enable anti-MEV protection")
+    .option("--condition-orders <json>", "JSON array of condition sub-orders for smart_trade (must include a buy_low entry + TP/SL entries)")
+    .option("--sell-param <json>", "JSON object of sell-side trade params used when a TP/SL condition fires (required for smart_trade)")
+    .option("--buy-param <json>", "JSON object of buy-side trade params override for smart_trade")
    .option("--raw", "Output raw JSON")
    .action(async (opts) => {
      if (!opts.amountIn && !opts.amountInPercent) {
@@ -239,13 +244,15 @@ export function registerSwapCommands(program: Command): void {
        quote_token: opts.quoteToken,
        order_type: opts.orderType,
        sub_order_type: opts.subOrderType,
-        check_price: opts.checkPrice,
      };
+      if (opts.checkPrice) params.check_price = opts.checkPrice;
+      if (opts.openPrice) params.open_price = opts.openPrice;
      if (opts.amountIn) params.amount_in = opts.amountIn;
      if (opts.amountInPercent) params.amount_in_percent = opts.amountInPercent;
      if (opts.limitPriceMode) params.limit_price_mode = opts.limitPriceMode;
      if (opts.expireIn != null) params.expire_in = opts.expireIn;
      if (opts.sellRatioType) params.sell_ratio_type = opts.sellRatioType;
+      if (opts.quoteInvestment) params.quote_investment = opts.quoteInvestment;
      if (opts.slippage != null) params.slippage = opts.slippage;
      if (opts.autoSlippage) params.auto_slippage = true;
      if (opts.priorityFee) params.priority_fee = opts.priorityFee;
@@ -256,6 +263,18 @@ export function registerSwapCommands(program: Command): void {
      if (opts.maxFeePerGas) params.max_fee_per_gas = opts.maxFeePerGas;
      if (opts.maxPriorityFeePerGas) params.max_priority_fee_per_gas = opts.maxPriorityFeePerGas;
      if (opts.antiMev) params.is_anti_mev = true;
+      if (opts.conditionOrders) {
+        try { params.condition_orders = JSON.parse(opts.conditionOrders); }
+        catch { console.error("[gmgn-cli] --condition-orders must be valid JSON"); process.exit(1); }
+      }
+      if (opts.sellParam) {
+        try { params.sell_param = JSON.parse(opts.sellParam); }
+        catch { console.error("[gmgn-cli] --sell-param must be valid JSON"); process.exit(1); }
+      }
+      if (opts.buyParam) {
+        try { params.buy_param = JSON.parse(opts.buyParam); }
+        catch { console.error("[gmgn-cli] --buy-param must be valid JSON"); process.exit(1); }
+      }
      const client = new OpenApiClient(getConfig(true));
      const data = await client.createStrategyOrder(params).catch(exitOnError);
      printResult(data, opts.raw);
@@ -7,6 +7,47 @@ import { validateChain } from "../validate.js";
 export function registerTrackCommands(program: Command): void {
  const track = program.command("track").description("On-chain tracking commands: follow-wallet trades, KOL trades, Smart Money trades");

+  track
+    .command("follow-tokens")
+    .description("Get the followed token list for a wallet on a given chain")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
+    .requiredOption("--wallet <address>", "Wallet address")
+    .option("--group-id <id>", "Filter by group: all_group (all), default, or a user-defined group ID")
+    .option("--interval <interval>", "Time interval for price change stats (e.g. 1m, 5m, 1h, 6h, 24h)")
+    .option("--order-by <field>", "Sort field: created_at / swaps / volume / market_cap / liquidity / price / open_timestamp")
+    .option("--direction <dir>", "Sort direction: asc / desc")
+    .option("--limit <n>", "Page size", parseInt)
+    .option("--cursor <cursor>", "Pagination cursor")
+    .option("--search <text>", "Search by token name or address")
+    .option("--raw", "Output raw JSON")
+    .action(async (opts) => {
+      validateChain(opts.chain);
+      const extra: Record<string, string | number> = {};
+      if (opts.groupId) extra["group_id"] = opts.groupId;
+      if (opts.interval) extra["interval"] = opts.interval;
+      if (opts.orderBy) extra["order_by"] = opts.orderBy;
+      if (opts.direction) extra["direction"] = opts.direction;
+      if (opts.limit != null) extra["limit"] = opts.limit;
+      if (opts.cursor) extra["cursor"] = opts.cursor;
+      if (opts.search) extra["search_text"] = opts.search;
+      const client = new OpenApiClient(getConfig());
+      const data = await client.getFollowTokens(opts.chain, opts.wallet, extra).catch(exitOnError);
+      printResult(data, opts.raw);
+    });
+
+  track
+    .command("follow-token-groups")
+    .description("Get the follow token group names for a wallet on a given chain")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base / eth")
+    .requiredOption("--wallet <address>", "Wallet address")
+    .option("--raw", "Output raw JSON")
+    .action(async (opts) => {
+      validateChain(opts.chain);
+      const client = new OpenApiClient(getConfig());
+      const data = await client.getFollowGroupNames(opts.chain, opts.wallet).catch(exitOnError);
+      printResult(data, opts.raw);
+    });
+
  track
    .command("follow-wallet")
    .description("Get follow-wallet trade records")
Author	SHA1	Message	Date
GMGN.AI	aa74d04839	1.4.7	2026-06-24 16:23:07 +08:00
GMGN.AI	6461d2f8df	chore: ignore local Claude Code dev configs	2026-06-24 16:22:55 +08:00
GMGN.AI	22d2ad25d5	Merge pull request #167 from GMGNAI/feat-quote-exist-auth docs(order-quote): order quote now uses normal auth, no private key needed	2026-06-24 16:21:20 +08:00
David Lau	25f4207351	fix(order-quote): switch quoteOrder to exist auth and update CLI help text - OpenApiClient.quoteOrder now calls authExistRequest instead of authSignedRequest - Remove all GMGN_PRIVATE_KEY references from the quote command description and options Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-24 16:13:37 +08:00
David Lau	d0ca1b40ce	docs(order-quote): order quote now uses normal auth, no private key needed quote endpoint downgraded to exist auth (API Key only); from_address no longer needs to match the key's bound wallet. Update all auth references in cli-usage.md, SKILL.md, and CLAUDE.md.	2026-06-22 16:55:51 +08:00
GMGN.AI	4e54086137	1.4.6	2026-06-18 11:59:38 +08:00
GMGN.AI	fcd14effbf	Merge pull request #165 from GumpOnchain/feat/add-bsc-launchpad-platforms feat(bsc): add new BSC launchpad platforms	2026-06-18 11:57:14 +08:00
gumponchain	d34315ce98	fix(bsc): update --platform hint text with new BSC launchpad names Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-18 11:52:04 +08:00
gumponchain	b6c4ff50f2	feat(bsc): add new BSC launchpad platforms Add cubepeg, likwid, goplus_creator, goplus_skills, openfour after four_xmode_agent; add flap_stocks and flap_aioracle after flap. Updates both TRENCHES_PLATFORMS defaults and SKILL.md examples. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-18 11:47:18 +08:00
GMGN.AI	e6dfca48d8	1.4.5	2026-06-16 11:19:13 +08:00
deepfeature	362d180910	Merge pull request #161 from GMGNAI/feat/add-user-agent-header feat(client): send User-Agent header on all API requests	2026-06-16 11:13:35 +08:00
deepfeature	d5c43eed51	feat(client): send User-Agent header on all API requests Add a `User-Agent: gmgn-cli/<version>` header (version read from package.json) to both authExistRequest and authSignedRequest, so upstream can identify CLI traffic and gateways that reject empty/default UAs do not block requests. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-16 11:12:10 +08:00
GMGN.AI	968013ebce	Merge pull request #160 from nova-0328/feat/cooking docs(cooking): clarify Flap fee-share schema and add real-world examples	2026-06-12 15:04:24 +08:00
prodev-nova	3d11f8c6d6	docs(cooking): clarify Flap fee-share schema and add real-world examples - Correct mkt_bps: it's the tax-recipient share (X handle in gift mode or split_conf addresses in split mode), not a generic "marketing" fund - Make twitter_account / split_conf conditional-required based on recipient_type instead of always required - Add two end-to-end Flap examples (split mode → BSC address, gift mode → X handle) - Merge "Full worked examples" into the Usage Examples section Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-12 14:54:11 +08:00
GMGN.AI	f15e8271f9	1.4.4	2026-06-11 12:07:35 +08:00
GMGN.AI	eda0ac9f52	Merge pull request #158 from GMGNAI/feat-add-follow-tokens-command Feat add follow tokens command	2026-06-11 11:53:40 +08:00
davidsx	b940c66c00	Merge pull request #156 from prodev-nova/feat/cooking fix(cooking): remove deprecated --interval-seconds flag	2026-06-05 21:18:04 +08:00
prodev-nova	1964e927cd	fix(cooking): remove deprecated --interval-seconds flag The interval_seconds param is no longer used. Removed from the CLI option, params assembly, CreateTokenParams, SKILL.md and cli-usage.md. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-05 21:03:23 +08:00
David Lau	0f3d550736	feat(track): add follow-token-groups subcommand Adds `track follow-token-groups` command that calls GET /v1/user/follow_token_groups to retrieve a wallet's token follow group names (id, name, rank) for a given chain. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-05 17:08:44 +08:00
GMGN.AI	23ca9d8670	1.4.3	2026-06-05 13:41:15 +08:00
GMGN.AI	67d53cd3e4	Merge pull request #154 from GMGNAI/fix/strategy-sell-buy-param fix(swap): add --sell-param and --buy-param to order strategy create	2026-06-05 13:40:28 +08:00
David Lau	ca51ee6a7a	fix(swap): add --sell-param and --buy-param to order strategy create Add CLI options and StrategyCreateParams fields for sell_param and buy_param, which were documented in SKILL.md but missing from the source. Reuses the existing TradeParam interface. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-05 12:04:47 +08:00
GMGN.AI	f5442f6247	1.4.2	2026-06-04 20:55:31 +08:00
GMGN.AI	0dabd4b93b	Merge pull request #153 from GMGNAI/fix/strategy-slippage-and-sell-param-docs fix(docs): update strategy examples slippage to integer and add sell-param	2026-06-04 20:54:53 +08:00
David Lau	73d81fa0b2	fix(docs): align slippage to integer 0–100 in all remaining files Update Readme.md, Readme.zh.md, src/commands/swap.ts and cooking.ts with integer 0–100 slippage examples (e.g. 30 = 30%) to match the updated API validation and skill docs. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-04 20:09:27 +08:00
David Lau	4ef54b0bcc	fix(docs): update strategy examples slippage to integer and add sell-param - Change example slippage values from 0.01 to 30 (integer 0-100 scale) - Add --sell-param option doc (required for smart_trade) - Add --buy-param option doc - Clarify --slippage description as integer 0-100 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-04 19:40:37 +08:00
David Lau	dd41e38755	feat(track): add follow-tokens subcommand Adds gmgn-cli track follow-tokens to query a wallet's followed token list on a given chain via GET /v1/user/follow_tokens. - Add getFollowTokens() to OpenApiClient (authExist) - Add track follow-tokens command with --chain, --wallet (required), --group-id, --interval, --order-by, --direction, --limit, --cursor, --search optional flags - Update SKILL.md: sub-commands table, rate limit table (weight 3), usage examples, options table, response fields - Update docs/cli-usage.md and Readme.md / Readme.zh.md Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-04 18:37:43 +08:00
GMGN.AI	2d0cb7348d	1.4.1	2026-06-04 17:12:00 +08:00
GMGN.AI	ddc025bb97	Merge pull request #152 from prodev-nova/feat/cooking docs(cooking): worked examples, platform matrix, TradeParam, anti-mev-mode fix	2026-06-04 17:11:17 +08:00
GMGN.AI	e9b08214a2	1.4.0	2026-06-04 17:08:55 +08:00
GMGN.AI	f96519941e	Merge pull request #151 from GMGNAI/feat/smart-trade-order-strategy feat(swap): add smart_trade order type to order strategy create	2026-06-04 17:04:37 +08:00
prodev-nova	fd8a1c4d2a	fix(cooking): anti-mev-mode values off / normal / secure Correct the --anti-mev-mode enum to off / normal / secure (across cooking.ts, SKILL.md, cli-usage.md, and the TradeParam examples). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-04 17:00:23 +08:00
prodev-nova	0282a9a09b	docs(cooking): add worked examples, platform matrix, TradeParam; fix anti-mev-mode values - Fix --anti-mev-mode values: off / jito / 0slot (was normal / secure) - Add platform capability matrix (per-platform fields, bundle/sniper wallet limits, cashback/mayhem support) - Add Quote Token conversion guidance for --raised-token launches - Add full TradeParam field table for --buy/sell-trade-config - Add two full worked CLI examples (Pump bundle+sniper+autosell+buyback, FourMeme fee-split + USDT raise token) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-04 16:34:27 +08:00
David Lau	17d7de841e	feat(swap): add smart_trade order type to order strategy create - Add --order-type smart_trade and --sub-order-type mix_trade support - Make --check-price optional (required for limit_order, omitted for smart_trade) - Add --open-price, --quote-investment, --condition-orders options - Update StrategyCreateParams interface: check_price optional, add condition_orders/quote_investment - Update SKILL.md and cli-usage.md docs with smart_trade examples and parameter table Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-06-04 14:27:01 +08:00
davidsx	bc64360e80	Merge pull request #150 from prodev-nova/fix/pump-fee-share-provider fix(cooking): correct pump fee-share provider values	2026-06-03 21:00:53 +08:00
prodev-nova	134a11593c	fix(cooking): correct pump fee-share provider values The pump_fee_share_list `provider` field rejected "wallet" with "unknown provider: wallet". Valid values are solana / twitter / github. - OpenApiClient: update PumpFeeShareInfo provider comment - SKILL.md / cli-usage.md: provider enum solana / twitter / github, username is a SOL address when provider = solana Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-03 20:50:54 +08:00
GMGN.AI	32d2fd2aac	1.3.9	2026-06-03 19:25:23 +08:00
GMGN.AI	8ed53df6d7	Merge pull request #149 from GMGNAI/fix/activity-type-camelcase fix(portfolio): rename activity type values to camelCase	2026-06-03 16:50:32 +08:00