gmgn-cli 1.1.8 → 1.1.10

package/Readme.md

@@ -10,7 +10,7 @@ English | [简体中文](Readme.zh.md)
 
 ## GMGN Agent Skills
 
-With GMGN Agent Skills, you can use AI agents to query real-time trending token rankings across multiple chains, token fundamentals, social media signals, live trading activity, new tokens in Trenches, top holders, top traders, smart money positions, KOL holdings, insider wallets, bundled wallet exposure, and other professional on-chain analytics. It also supports market orders, limit orders, advanced take-profit/stop-loss strategy orders, and wallet management — including real-time holdings, recent P&L, and transaction history — all through natural language.
+With GMGN Agent Skills, you can use AI agents to query real-time trending token rankings across multiple chains, token fundamentals, social media signals, live trading activity, new tokens in Trenches, top holders, top traders, smart money positions, KOL holdings, insider wallets, bundled wallet exposure, and other professional on-chain analytics. It also supports market orders, limit orders, advanced take-profit/stop-loss strategy orders, one-command cooking orders (buy + condition orders in a single flow), and wallet management — including real-time holdings, recent P&L, and transaction history — all through natural language.
 
 ---
 
@@ -89,7 +89,8 @@ No more scraping web pages or getting blocked by Cloudflare. Query all the profe
 | [`/gmgn-market`](skills/gmgn-market/SKILL.md) | K-line market data, trending tokens | [SKILL.md](skills/gmgn-market/SKILL.md) |
 | [`/gmgn-portfolio`](skills/gmgn-portfolio/SKILL.md) | Wallet holdings, activity, stats | [SKILL.md](skills/gmgn-portfolio/SKILL.md) |
 | [`/gmgn-track`](skills/gmgn-track/SKILL.md) | Follow-wallet trades, KOL trades, Smart Money trades | [SKILL.md](skills/gmgn-track/SKILL.md) |
-| [`/gmgn-swap`](skills/gmgn-swap/SKILL.md) | Swap submission + order query | [SKILL.md](skills/gmgn-swap/SKILL.md) |
+| [`/gmgn-swap`](skills/gmgn-swap/SKILL.md) | Swap submission + limit orders + strategy orders + order query | [SKILL.md](skills/gmgn-swap/SKILL.md) |
+| [`/gmgn-cooking`](skills/gmgn-cooking/SKILL.md) | One-command cooking orders (buy + take-profit/stop-loss in a single flow) | [SKILL.md](skills/gmgn-cooking/SKILL.md) |
 
 > For detailed CLI commands, parameters, and recommended values, see the [Wiki documentation](https://github.com/GMGNAI/gmgn-skills/wiki).
 
@@ -99,7 +100,7 @@ No more scraping web pages or getting blocked by Cloudflare. Query all the profe
 
 Ready to install? [Jump to Installation →](#1-installation)
 
-Already installed? [Upgrade Skills and CLI →](#9-upgrade-skills-and-cli)
+Already installed? [Upgrade Skills and CLI →](#10-upgrade-skills-and-cli)
 
 > **Tip:** If your AI agent tries to open or scrape the gmgn.ai website instead of using the CLI, add this to your prompt: `Use gmgn-cli commands. Do not call gmgn.ai web endpoints directly.`
 
@@ -115,19 +116,23 @@ Already installed? [Upgrade Skills and CLI →](#9-upgrade-skills-and-cli)
 npx skills add GMGNAI/gmgn-skills
 ```
 
-**Step 2 — Verify with public key (no registration needed)**
+**Step 2 — Verify CLI installation (demo key)**
 
 ```bash
 GMGN_API_KEY=gmgn_solbscbaseethmonadtron gmgn-cli market trending --chain sol --interval 1h --limit 3
 ```
 
-If JSON output appears, the CLI is working.
+If JSON output appears, the CLI is installed correctly. **Setup is NOT yet complete — this is a public demo key for testing only. You must continue to Steps 3–4 to configure the user's personal API key. Do not stop here.**
 
-**Step 3 — Guide user to get their own API key**
+**Step 3 — REQUIRED: Set up personal API key**
 
-Tell the user: "To use your own API key, go to **https://gmgn.ai/ai** and apply. You will need an Ed25519 public key. I can generate a key pair for you — just say the word."
+⚠️ This step is mandatory. The demo key in Step 2 supports testing only and is not for actual use.
 
-When the user asks, run:
+Immediately tell the user the following, then run the key generation command **without waiting for them to ask**:
+
+> "To use GMGN Skills, you need your own API key from **https://gmgn.ai/ai**. I'm generating an Ed25519 key pair for you now."
+
+Run:
 
 ```bash
 openssl genpkey -algorithm ed25519 -out /tmp/gmgn_private.pem 2>/dev/null && \
@@ -140,7 +145,7 @@ Show the **public key** to the user with the following instructions:
 > 1. Go to **https://gmgn.ai/ai**, paste the public key above into the API Key creation form, and submit.
 > 2. Once created, copy the **API Key** shown on the page and send it back to me — I'll handle Step 4 configuration for you.
 
-Wait for the user to reply with their API Key before continuing to Step 4.
+**Wait for the user to reply with their API Key before continuing to Step 4.**
 
 **Step 4 — Configure credentials**
 
@@ -172,9 +177,10 @@ If output appears without error, setup is complete.
 
 ## Upgrade (AI Agent)
 
-> Run this command to upgrade both the CLI and Skills to the latest version.
+> Run these two commands to upgrade both the CLI and Skills to the latest version.
 
 ```bash
+npm install -g gmgn-cli
 npx skills add GMGNAI/gmgn-skills
 ```
 
@@ -184,7 +190,7 @@ Check the installed version after upgrading:
 gmgn-cli --version
 ```
 
-> For the full upgrade reference, see [Section 9 — Upgrade Skills and CLI](#9-upgrade-skills-and-cli).
+> For the full upgrade reference, see [Section 10 — Upgrade Skills and CLI](#10-upgrade-skills-and-cli).
 
 ---
 
@@ -336,7 +342,7 @@ Skills are automatically discovered via the `.cursor-plugin/` configuration.
    ```bash
    echo "$(npm root -g)/gmgn-skills/skills"
    ```
-3. Restart Cline — `/gmgn-token`, `/gmgn-market`, `/gmgn-portfolio`, `/gmgn-track`, `/gmgn-swap` will be available
+3. Restart Cline — `/gmgn-token`, `/gmgn-market`, `/gmgn-portfolio`, `/gmgn-track`, `/gmgn-swap`, `/gmgn-cooking` will be available
 
 #### Codex CLI
 
@@ -369,12 +375,23 @@ Natural language prompts you can send to any AI assistant with gmgn-cli skills i
 ```
 buy 0.1 SOL of <token_address>
 sell 50% of <token_address> on BSC
+sell 30% of my <token_address> position
+get a quote: how much <token_address> can I get for 1 SOL?
 check order status <order_id>
 is <token_address> safe to buy on solana?
 show top holders of <token_address>
+show smart money holdings of <token_address>, sorted by buy volume
+show recent KOL trades for <token_address>
 show my wallet holdings on SOL
 query token details for 0x1234...
+show 24h K-line and volume for <token_address>
 show trading stats for wallet <wallet_address> on BSC
+show recent trades for wallet <wallet_address>
+which wallets are linked to my API key, and what are their balances
+show the latest smart money trades on SOL
+show what KOLs are buying on SOL
+show newly launched tokens on Solana
+show Solana 1-minute trending tokens
 ```
 
 ### Typical Workflows
@@ -424,52 +441,116 @@ Full parameter reference: [docs/cli-usage.md](docs/cli-usage.md). All commands s
 ### Token
 
 ```bash
-npx gmgn-cli token info --chain sol --address <addr>
+gmgn-cli token info --chain sol --address <addr>
 ```
 
 ### Market
 
 ```bash
-npx gmgn-cli market trending \
+gmgn-cli market trending \
   --chain sol \
   --interval 1h \
   --order-by volume --limit 20 \
   --filter not_risk --filter not_honeypot
 
-npx gmgn-cli market trenches \
+gmgn-cli market trenches \
   --chain sol \
   --type new_creation --type near_completion --type completed \
   --launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform letsbonk \
   --limit 80
+
+# With server-side filters: safe preset + require smart money + sort by smart degen count
+gmgn-cli market trenches \
+  --chain sol --type new_creation \
+  --filter-preset safe --min-smart-degen-count 1 --sort-by smart_degen_count
 ```
 
 ### Portfolio
 
 ```bash
-npx gmgn-cli portfolio holdings --chain sol --wallet <addr>
+# Holdings
+gmgn-cli portfolio holdings --chain sol --wallet <addr>
+
+# Activity
+gmgn-cli portfolio activity --chain sol --wallet <addr>
+
+# Stats (supports multiple wallets)
+gmgn-cli portfolio stats --chain sol --wallet <addr1> --wallet <addr2>
+
+# Wallets and balances linked to API key
+gmgn-cli portfolio info
+
+# Single token balance
+gmgn-cli portfolio token-balance --chain sol --wallet <addr> --token <token_addr>
 ```
 
 ### Track
 
 ```bash
 # Follow-wallet trade records (requires GMGN_PRIVATE_KEY)
-npx gmgn-cli track follow-wallet --chain sol
-npx gmgn-cli track follow-wallet --chain sol --wallet <wallet_address> --side buy
+gmgn-cli track follow-wallet --chain sol
+gmgn-cli track follow-wallet --chain sol --wallet <wallet_address> --side buy
 
 # KOL trade records
-npx gmgn-cli track kol --limit 100 --raw
-npx gmgn-cli track kol --chain sol --side buy --limit 50 --raw
+gmgn-cli track kol --limit 100 --raw
+gmgn-cli track kol --chain sol --side buy --limit 50 --raw
 
 # Smart Money trade records
-npx gmgn-cli track smartmoney --limit 100 --raw
-npx gmgn-cli track smartmoney --chain sol --side sell --limit 50 --raw
+gmgn-cli track smartmoney --limit 100 --raw
+gmgn-cli track smartmoney --chain sol --side sell --limit 50 --raw
+```
+
+### Limit Orders (requires private key)
+
+```bash
+# Create a take-profit order
+gmgn-cli order strategy create \
+  --chain sol \
+  --from <wallet_address> \
+  --base-token <token_address> \
+  --quote-token <sol_address> \
+  --sub-order-type take_profit \
+  --check-price 0.002 \
+  --amount-in-percent 100 \
+  --slippage 0.01
+
+# Create a stop-loss order
+gmgn-cli order strategy create \
+  --chain sol \
+  --from <wallet_address> \
+  --base-token <token_address> \
+  --quote-token <sol_address> \
+  --sub-order-type stop_loss \
+  --check-price 0.0005 \
+  --amount-in-percent 100 \
+  --slippage 0.01
+
+# List open strategy orders
+gmgn-cli order strategy list --chain sol
+
+# Cancel a strategy order
+gmgn-cli order strategy cancel --chain sol --from <wallet_address> --order-id <order_id>
+```
+
+### Cooking (requires private key)
+
+```bash
+# Buy token and automatically attach take-profit + stop-loss condition orders
+gmgn-cli cooking \
+  --chain sol \
+  --from <wallet_address> \
+  --input-token So11111111111111111111111111111111111111112 \
+  --output-token <token_address> \
+  --amount 1000000000 \
+  --slippage 0.1 \
+  --condition-orders '[{"order_type":"profit_stop","side":"sell","price_scale":"200","sell_ratio":"100"},{"order_type":"loss_stop","side":"sell","price_scale":"50","sell_ratio":"100"}]'
 ```
 
 ### Swap (requires private key)
 
 ```bash
 # Submit swap with fixed slippage
-npx gmgn-cli swap \
+gmgn-cli swap \
   --chain sol \
   --from <wallet-address> \
   --input-token <input-token-addr> \
@@ -478,7 +559,7 @@ npx gmgn-cli swap \
   --slippage 0.01
 
 # Submit swap with automatic slippage
-npx gmgn-cli swap \
+gmgn-cli swap \
   --chain sol \
   --from <wallet-address> \
   --input-token <input-token-addr> \
@@ -486,11 +567,29 @@ npx gmgn-cli swap \
   --amount 1000000 \
   --auto-slippage
 
+# Sell by position percentage (e.g. sell 50%)
+gmgn-cli swap \
+  --chain sol \
+  --from <wallet-address> \
+  --input-token <token-addr> \
+  --output-token <usdc-addr> \
+  --percent 50 \
+  --auto-slippage
+
+# Get quote (no transaction submitted)
+gmgn-cli order quote \
+  --chain sol \
+  --from <wallet-address> \
+  --input-token <input-token-addr> \
+  --output-token <output-token-addr> \
+  --amount 1000000 \
+  --slippage 0.01
+
 # Query order
-npx gmgn-cli order get --chain sol --order-id <order-id>
+gmgn-cli order get --chain sol --order-id <order-id>
 ```
 
-## 8. Supported Chains
+## 9. Supported Chains
 
 | Commands | Chains | Chain Currencies |
 |----------|--------|-----------------|
@@ -499,10 +598,13 @@ npx gmgn-cli order get --chain sol --order-id <order-id>
 
 ---
 
-## 9. Upgrade Skills and CLI
+## 10. Upgrade Skills and CLI
 
 ```bash
-# Upgrade CLI and Skills
+# Upgrade CLI
+npm install -g gmgn-cli
+
+# Upgrade Skills
 npx skills add GMGNAI/gmgn-skills
 
 # Check current version
@@ -513,7 +615,7 @@ gmgn-cli --version
 
 ---
 
-## 10. Security & Disclaimer (Read Before Use)
+## 11. Security & Disclaimer (Read Before Use)
 
 This tool can be invoked by an AI Agent to submit real on-chain transactions automatically. It carries inherent risks including model hallucination, uncontrolled execution, and prompt injection. Once authorized, the AI Agent will submit transactions on behalf of your linked wallet address — **on-chain transactions are irreversible once confirmed** and may result in financial loss. Use with caution.
 

package/Readme.zh.md

@@ -10,7 +10,7 @@
 
 ## GMGN Agent Skills
 
-使用 GMGN Agent Skills，你可以通过 AI Agent 实时查询多个链上热门代币排行榜，代币基础信息，社交媒体信息，实时交易动态，实时战壕新币，报持仓大户（Top Holder），交易大户（Top Trader），聪明钱持仓占比，KOL持仓占比，老鼠仓持仓，捆绑持仓占比，等代币专业数据分析数据，以及支持代币市价单交易、限价单交易、高级止盈止损策略单交易，以及钱包资产管理相关功能，例如查询钱包实时持仓、钱包最近盈亏、钱包交易动态等，全部通过自然语言与 AI Agent 交互即可完成。
+使用 GMGN Agent Skills，你可以通过 AI Agent 实时查询多个链上热门代币排行榜，代币基础信息，社交媒体信息，实时交易动态，实时战壕新币，报持仓大户（Top Holder），交易大户（Top Trader），聪明钱持仓占比，KOL持仓占比，老鼠仓持仓，捆绑持仓占比，等代币专业数据分析数据，以及支持代币市价单交易、限价单交易、高级止盈止损策略单交易、一键 Cooking 策略单（买入 + 条件单一体化），以及钱包资产管理相关功能，例如查询钱包实时持仓、钱包最近盈亏、钱包交易动态等，全部通过自然语言与 AI Agent 交互即可完成。
 
 ---
 
@@ -92,7 +92,8 @@ SOL / BSC / Base 多链数据每次查询均为实时，支持多参数个性化
 | [`/gmgn-market`](skills/gmgn-market/SKILL.md) | K 线行情数据、热门代币 | [SKILL.md](skills/gmgn-market/SKILL.md) |
 | [`/gmgn-portfolio`](skills/gmgn-portfolio/SKILL.md) | 钱包持仓、活动、统计 | [SKILL.md](skills/gmgn-portfolio/SKILL.md) |
 | [`/gmgn-track`](skills/gmgn-track/SKILL.md) | 追踪关注钱包交易动态、KOL 交易动态、聪明钱交易动态 | [SKILL.md](skills/gmgn-track/SKILL.md) |
-| [`/gmgn-swap`](skills/gmgn-swap/SKILL.md) | 兑换提交 + 订单查询 | [SKILL.md](skills/gmgn-swap/SKILL.md) |
+| [`/gmgn-swap`](skills/gmgn-swap/SKILL.md) | 兑换提交 + 限价单 + 策略单 + 订单查询 | [SKILL.md](skills/gmgn-swap/SKILL.md) |
+| [`/gmgn-cooking`](skills/gmgn-cooking/SKILL.md) | 一键 Cooking 策略单（买入 + 止盈止损条件单一体化） | [SKILL.md](skills/gmgn-cooking/SKILL.md) |
 
 > 如需查看详细的 CLI 接口说明、传参格式和推荐值，请参阅 [Wiki 文档](https://github.com/GMGNAI/gmgn-skills/wiki/Home-Chinese)。
 
@@ -102,7 +103,7 @@ SOL / BSC / Base 多链数据每次查询均为实时，支持多参数个性化
 
 已准备好？[点击这里开始安装 Skills →](#开始安装-skills)
 
-已安装？[升级 Skills 和 CLI →](#9-升级-skills-和-cli)
+已安装？[升级 Skills 和 CLI →](#10-升级-skills-和-cli)
 
 > **提示：** 如果你的 AI Agent 尝试直接打开 gmgn.ai 网站而不是使用 CLI，请在提示词中加上：
 > ```
@@ -121,19 +122,23 @@ SOL / BSC / Base 多链数据每次查询均为实时，支持多参数个性化
 npx skills add GMGNAI/gmgn-skills
 ```
 
-**第 2 步 — 用公共 Key 验证（无需注册）**
+**第 2 步 — 验证 CLI 安装（演示 Key）**
 
 ```bash
 GMGN_API_KEY=gmgn_solbscbaseethmonadtron gmgn-cli market trending --chain sol --interval 1h --limit 3
 ```
 
-看到 JSON 输出即表示 CLI 正常工作。
+看到 JSON 输出说明 CLI 已安装成功。**但配置尚未完成 —— 此公共演示 Key 仅用于测试，不可用于实际使用。必须继续完成第 3～4 步，为用户配置个人 API Key。请勿在此停止。**
 
-**第 3 步 — 引导用户申请个人 API Key**
+**第 3 步 — 必须完成：配置个人 API Key**
 
-告知用户："需要个人 API Key，请前往 **https://gmgn.ai/ai** 申请。申请时需要一个 Ed25519 公钥，我可以帮你生成密钥对，告诉我一声就行。"
+⚠️ 此步骤为必填项。第 2 步中的演示 Key 仅支持测试，无法用于正式使用。
 
-用户确认后运行：
+请**立即**告知用户以下内容，并**无需等待用户主动询问**，直接运行密钥生成命令：
+
+> "使用 GMGN Skills 需要你自己的个人 API Key，申请地址：**https://gmgn.ai/ai**。我现在为你生成 Ed25519 密钥对。"
+
+运行：
 
 ```bash
 openssl genpkey -algorithm ed25519 -out /tmp/gmgn_private.pem 2>/dev/null && \
@@ -146,7 +151,7 @@ openssl genpkey -algorithm ed25519 -out /tmp/gmgn_private.pem 2>/dev/null && \
 > 1. 打开 **https://gmgn.ai/ai**，将上方公钥填入 API Key 生成表单，完成创建。
 > 2. 创建完成后，将页面上显示的 **API Key** 复制并发送给我，我来帮你完成第 4 步配置。
 
-等用户回复 API Key 后，再继续第 4 步。
+**等用户回复 API Key 后，再继续第 4 步。**
 
 **第 4 步 — 配置凭证**
 
@@ -178,9 +183,10 @@ gmgn-cli market trending --chain sol --interval 1h --limit 3
 
 ## AI Agent 升级
 
-> 运行以下命令，将 CLI 和 Skills 同时升级到最新版本。
+> 运行以下两条命令，将 CLI 和 Skills 同时升级到最新版本。
 
 ```bash
+npm install -g gmgn-cli
 npx skills add GMGNAI/gmgn-skills
 ```
 
@@ -190,7 +196,7 @@ npx skills add GMGNAI/gmgn-skills
 gmgn-cli --version
 ```
 
-> 完整升级说明请参阅[第 9 节 — 升级 Skills 和 CLI](#9-升级-skills-和-cli)。
+> 完整升级说明请参阅[第 10 节 — 升级 Skills 和 CLI](#10-升级-skills-和-cli)。
 
 ---
 
@@ -219,15 +225,6 @@ gmgn-cli --version
 
 ---
 
-## 开始安装 Skills
-
-安装前，请先在 **https://gmgn.ai/ai** 创建 API Key，用于：
-
-1. 读取数据：代币、榜单、K 线、特色数据指标
-2. 提交交易：市价立即交易、创建限价单、策略单等
-
----
-
 ## 1. 安装
 
 选择以下任意一种方式
@@ -256,20 +253,10 @@ node dist/index.js <command> [options]
 
 ## 2. 验证连通性
 
-### 方式一：通过 AI Agent 验证
-
-发送以下提示词给你的 AI Agent：
-
-```
-执行这个cli命令：GMGN_API_KEY=gmgn_solbscbaseethmonadtron npx gmgn-cli market trending --chain sol --interval 1h --limit 3
-```
-
-### 方式二：通过 CLI 验证
-
 使用公共 API Key 测试，无需注册：
 
 ```bash
-GMGN_API_KEY=gmgn_solbscbaseethmonadtron npx gmgn-cli market trending --chain sol --interval 1h --limit 3
+GMGN_API_KEY=gmgn_solbscbaseethmonadtron gmgn-cli market trending --chain sol --interval 1h --limit 3
 ```
 
 看到 JSON 输出即表示 CLI 正常工作。公共 Key 支持所有只读接口（token / market / portfolio），公共 Key 仅用于测试，正式使用任何接口均需申请个人 API Key（见第 3 步）。
@@ -359,7 +346,7 @@ cp .env.example .env
    ```bash
    echo "$(npm root -g)/gmgn-skills/skills"
    ```
-3. 重启 Cline — `/gmgn-token`、`/gmgn-market`、`/gmgn-portfolio`、`/gmgn-track`、`/gmgn-swap` 即可使用
+3. 重启 Cline — `/gmgn-token`、`/gmgn-market`、`/gmgn-portfolio`、`/gmgn-track`、`/gmgn-swap`、`/gmgn-cooking` 即可使用
 
 #### Codex CLI
 
@@ -503,6 +490,11 @@ gmgn-cli market trenches \
   --type new_creation --type near_completion --type completed \
   --launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform letsbonk \
   --limit 80
+
+# 服务端过滤：安全预设 + 要求有聪明钱 + 按聪明钱数量排序
+gmgn-cli market trenches \
+  --chain sol --type new_creation \
+  --filter-preset safe --min-smart-degen-count 1 --sort-by smart_degen_count
 ```
 
 ### Portfolio
@@ -540,6 +532,52 @@ gmgn-cli track smartmoney --limit 100 --raw
 gmgn-cli track smartmoney --chain sol --side sell --limit 50 --raw
 ```
 
+### 限价单（需要私钥）
+
+```bash
+# 创建止盈单
+gmgn-cli order strategy create \
+  --chain sol \
+  --from <wallet_address> \
+  --base-token <token_address> \
+  --quote-token <sol_address> \
+  --sub-order-type take_profit \
+  --check-price 0.002 \
+  --amount-in-percent 100 \
+  --slippage 0.01
+
+# 创建止损单
+gmgn-cli order strategy create \
+  --chain sol \
+  --from <wallet_address> \
+  --base-token <token_address> \
+  --quote-token <sol_address> \
+  --sub-order-type stop_loss \
+  --check-price 0.0005 \
+  --amount-in-percent 100 \
+  --slippage 0.01
+
+# 查看当前挂单
+gmgn-cli order strategy list --chain sol
+
+# 撤销策略单
+gmgn-cli order strategy cancel --chain sol --from <wallet_address> --order-id <order_id>
+```
+
+### Cooking 一键策略单（需要私钥）
+
+```bash
+# 买入代币，同时自动挂止盈 + 止损条件单
+gmgn-cli cooking \
+  --chain sol \
+  --from <wallet_address> \
+  --input-token So11111111111111111111111111111111111111112 \
+  --output-token <token_address> \
+  --amount 1000000000 \
+  --slippage 0.1 \
+  --condition-orders '[{"order_type":"profit_stop","side":"sell","price_scale":"200","sell_ratio":"100"},{"order_type":"loss_stop","side":"sell","price_scale":"50","sell_ratio":"100"}]'
+```
+
 ### Swap（需要私钥）
 
 ```bash
@@ -583,7 +621,7 @@ gmgn-cli order quote \
 gmgn-cli order get --chain sol --order-id <order-id>
 ```
 
-## 8. 支持的链
+## 9. 支持的链
 
 | 接口类型 | 支持的链 | 链原生货币 |
 |----------|----------|-----------|
@@ -592,7 +630,7 @@ gmgn-cli order get --chain sol --order-id <order-id>
 
 ---
 
-## 9. 升级 Skills 和 CLI
+## 10. 升级 Skills 和 CLI
 
 将 `gmgn-cli` 和 Skills 升级到最新版本：
 
@@ -624,7 +662,7 @@ gmgn-cli --version
 
 ---
 
-## 10. 安全与免责（使用前必读）
+## 11. 安全与免责（使用前必读）
 
 本工具可供 AI Agent 调用以自动执行链上交易，存在模型幻觉、执行不可控、提示词注入等固有风险。AI Agent 在获得授权后，将以您绑定的钱包地址提交真实的链上交易，**交易一经上链即不可撤销**，可能导致资金损失，请您谨慎使用。
 

package/dist/client/OpenApiClient.d.ts

@@ -30,6 +30,69 @@ export interface SwapParams {
     gas_price?: string;
     max_fee_per_gas?: string;
     max_priority_fee_per_gas?: string;
+    condition_orders?: StrategyConditionOrder[];
+    sell_ratio_type?: string;
+}
+export interface StrategyConditionOrder {
+    order_type: string;
+    side: string;
+    price_scale: string;
+    sell_ratio: string;
+}
+export interface StrategyCreateParams {
+    chain: string;
+    from_address: string;
+    base_token: string;
+    quote_token: string;
+    order_type: string;
+    sub_order_type: string;
+    check_price: string;
+    amount_in?: string;
+    amount_in_percent?: string;
+    limit_price_mode?: string;
+    price_gap_ratio?: string;
+    expire_in?: number;
+    sell_ratio_type?: string;
+    slippage?: number;
+    auto_slippage?: boolean;
+    fee?: string;
+    gas_price?: string;
+    max_fee_per_gas?: string;
+    max_priority_fee_per_gas?: string;
+    is_anti_mev?: boolean;
+    anti_mev_mode?: string;
+    priority_fee?: string;
+    tip_fee?: string;
+    custom_rpc?: string;
+}
+export interface StrategyCancelParams {
+    chain: string;
+    from_address: string;
+    order_id: string;
+    order_type?: string;
+    close_sell_model?: string;
+}
+export interface CreateTokenParams {
+    chain: string;
+    dex: string;
+    from_address: string;
+    name: string;
+    symbol: string;
+    buy_amt: string;
+    image?: string;
+    image_url?: string;
+    website?: string;
+    twitter?: string;
+    telegram?: string;
+    slippage?: number;
+    auto_slippage?: boolean;
+    priority_fee?: string;
+    tip_fee?: string;
+    gas_price?: string;
+    max_priority_fee_per_gas?: string;
+    max_fee_per_gas?: string;
+    is_anti_mev?: boolean;
+    anti_mev_mode?: string;
 }
 export declare class OpenApiClient {
     private readonly apiKey;
@@ -46,7 +109,7 @@ export declare class OpenApiClient {
     getWalletActivity(chain: string, walletAddress: string, extra?: Record<string, string | number | string[]>): Promise<unknown>;
     getWalletStats(chain: string, walletAddresses: string[], period?: string): Promise<unknown>;
     getWalletTokenBalance(chain: string, walletAddress: string, tokenAddress: string): Promise<unknown>;
-    getTrenches(chain: string, types?: string[], platforms?: string[], limit?: number): Promise<unknown>;
+    getTrenches(chain: string, types?: string[], platforms?: string[], limit?: number, filters?: Record<string, number | string>): Promise<unknown>;
     getTrendingSwaps(chain: string, interval: string, extra?: Record<string, string | number | string[]>): Promise<unknown>;
     getUserInfo(): Promise<unknown>;
     getFollowWallet(chain: string, extra?: Record<string, string | number | string[]>): Promise<unknown>;
@@ -55,8 +118,14 @@ export declare class OpenApiClient {
     quoteOrder(chain: string, from_address: string, input_token: string, output_token: string, input_amount: string, slippage: number): Promise<unknown>;
     swap(params: SwapParams): Promise<unknown>;
     queryOrder(orderId: string, chain: string): Promise<unknown>;
+    createStrategyOrder(params: StrategyCreateParams): Promise<unknown>;
+    getStrategyOrders(chain: string, extra?: Record<string, string | number>): Promise<unknown>;
+    cancelStrategyOrder(params: StrategyCancelParams): Promise<unknown>;
+    getCookingStatistics(): Promise<unknown>;
+    createToken(params: CreateTokenParams): Promise<unknown>;
     private normalRequest;
     private criticalRequest;
+    private executePreparedRequest;
     private doFetch;
     private parseResponse;
 }

package/dist/client/OpenApiClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OpenApiClient.d.ts","sourceRoot":"","sources":["../../src/client/OpenApiClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"OpenApiClient.d.ts","sourceRoot":"","sources":["../../src/client/OpenApiClient.ts"],"names":[],"mappings":"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"}