feat(portfolio): add created-tokens command for developer wallet token history

Add GET /v1/user/created_tokens support: portfolio created-tokens CLI command,
OpenApiClient method, SKILL.md docs, cli-usage.md, and Readme examples.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Readme.md

@@ -490,14 +490,17 @@ gmgn-cli portfolio info
 
 # Single token balance
 gmgn-cli portfolio token-balance --chain sol --wallet <addr> --token <token_addr>
+
+# Tokens created by a developer wallet
+gmgn-cli portfolio created-tokens --chain sol --wallet <addr>
 ```
 
 ### Track
 
 ```bash
-# Follow-wallet trade records (requires GMGN_PRIVATE_KEY)
+# Follow-wallet trade records
 gmgn-cli track follow-wallet --chain sol
-gmgn-cli track follow-wallet --chain sol --wallet <wallet_address> --side buy
+gmgn-cli track follow-wallet --chain sol --limit 20 --min-amount-usd 1000
 
 # KOL trade records
 gmgn-cli track kol --limit 100 --raw
@@ -558,6 +561,15 @@ gmgn-cli order quote \
 
 # Query order
 gmgn-cli order get --chain sol --order-id <order-id>
+
+# Multi-wallet concurrent swap
+gmgn-cli multi-swap \
+  --chain sol \
+  --accounts <addr1>,<addr2> \
+  --input-token <input-token-addr> \
+  --output-token <output-token-addr> \
+  --input-amount '{"<addr1>":"1000000","<addr2>":"2000000"}' \
+  --slippage 0.01
 ```
 
 > `order quote` uses critical auth on `sol` / `bsc` / `base` and requires `GMGN_PRIVATE_KEY`.

Readme.zh.md

@@ -521,14 +521,17 @@ gmgn-cli portfolio info
 
 # 单个 token 余额
 gmgn-cli portfolio token-balance --chain sol --wallet <addr> --token <token_addr>
+
+# 查询开发者钱包创建的代币列表
+gmgn-cli portfolio created-tokens --chain sol --wallet <addr>
 ```
 
 ### Track
 
 ```bash
-# 追踪关注钱包的交易动态（需要 GMGN_PRIVATE_KEY）
+# 追踪关注钱包的交易动态
 gmgn-cli track follow-wallet --chain sol
-gmgn-cli track follow-wallet --chain sol --wallet <wallet_address> --side buy
+gmgn-cli track follow-wallet --chain sol --limit 20 --min-amount-usd 1000
 
 # KOL 交易动态
 gmgn-cli track kol --limit 100 --raw
@@ -589,6 +592,15 @@ gmgn-cli order quote \
 
 # 查询订单状态
 gmgn-cli order get --chain sol --order-id <order-id>
+
+# 多钱包并发 Swap
+gmgn-cli multi-swap \
+  --chain sol \
+  --accounts <addr1>,<addr2> \
+  --input-token <input-token-addr> \
+  --output-token <output-token-addr> \
+  --input-amount '{"<addr1>":"1000000","<addr2>":"2000000"}' \
+  --slippage 0.01
 ```
 
 > `order quote` 在 `sol` / `bsc` / `base` 上都走关键鉴权，必须配置 `GMGN_PRIVATE_KEY`。

docs/cli-usage.md

@@ -255,6 +255,30 @@ npx gmgn-cli portfolio token-balance \
 
 ---
 
+## portfolio created-tokens
+
+Query tokens created by a developer wallet.
+
+```bash
+npx gmgn-cli portfolio created-tokens \
+  --chain <chain> \
+  --wallet <wallet_address> \
+  [--order-by <field>] \
+  [--direction asc|desc] \
+  [--migrate-state <state>] \
+  [--raw]
+```
+
+| Option | Required | Description |
+|--------|----------|-------------|
+| `--chain` | Yes | `sol` / `bsc` / `base` |
+| `--wallet` | Yes | Developer wallet address |
+| `--order-by` | No | Sort field: `market_cap` / `token_ath_mc` |
+| `--direction` | No | Sort direction: `asc` / `desc` |
+| `--migrate-state` | No | Filter: `migrated` / `non_migrated` |
+
+---
+
 ## market trenches
 
 Query Trenches token lists (new creation, near completion, completed).
@@ -276,69 +300,61 @@ npx gmgn-cli market trenches --chain <chain> [--type <type...>] [--launchpad-pla
 
 ## portfolio follow-wallet
 
-Query follow-wallet trade records.
+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. Normal auth (API Key only, no private key needed).
 
 ```bash
-npx gmgn-cli portfolio follow-wallet \
+gmgn-cli track follow-wallet \
   --chain <chain> \
   [--wallet <wallet_address>] \
-  [--base-token <token_address>] \
-  [--page-token <cursor>] \
   [--limit <n>] \
   [--side <side>] \
-  [--cost <cost>] \
   [--filter <tag>] \
-  [--with-balance] \
-  [--with-security] \
   [--min-amount-usd <n>] \
   [--max-amount-usd <n>] \
-  [--is-gray] \
   [--raw]
 ```
 
 | Option | Required | Description |
 |--------|----------|-------------|
-| `--chain` | Yes | `sol` / `bsc` / `base` / `eth` |
-| `--wallet` | No | Filter by wallet address |
-| `--base-token` | No | Filter by base token address |
-| `--page-token` | No | Pagination cursor |
-| `--limit` | No | Page size (1–200, default 100) |
-| `--side` | No | Trade direction filter |
-| `--cost` | No | Cost filter |
+| `--chain` | Yes | `sol` / `bsc` / `base` |
+| `--wallet` | No | Wallet address (optional; follow list resolved from API Key's bound user account) |
+| `--limit` | No | Page size (1–100, default 10) |
+| `--side` | No | Trade direction: `buy` / `sell` |
 | `--filter` | No | Filter conditions (repeatable) |
-| `--with-balance` | No | Include balance in response |
-| `--with-security` | No | Include security info in response |
 | `--min-amount-usd` | No | Minimum trade amount (USD) |
 | `--max-amount-usd` | No | Maximum trade amount (USD) |
-| `--is-gray` | No | Gray mode filter |
 
 ---
 
 ## portfolio kol
 
-Query KOL trade records (SOL chain).
+Query KOL trade records.
 
 ```bash
-npx gmgn-cli portfolio kol [--limit <n>] [--raw]
+gmgn-cli track kol [--chain <chain>] [--limit <n>] [--side <side>] [--raw]
 ```
 
 | Option | Required | Description |
 |--------|----------|-------------|
+| `--chain` | No | `sol` / `bsc` / `base` (default `sol`) |
 | `--limit` | No | Page size (1–200, default 100) |
+| `--side` | No | Filter by trade direction: `buy` / `sell` (client-side filter) |
 
 ---
 
 ## portfolio smartmoney
 
-Query Smart Money trade records (SOL chain).
+Query Smart Money trade records.
 
 ```bash
-npx gmgn-cli portfolio smartmoney [--limit <n>] [--raw]
+gmgn-cli track smartmoney [--chain <chain>] [--limit <n>] [--side <side>] [--raw]
 ```
 
 | Option | Required | Description |
 |--------|----------|-------------|
+| `--chain` | No | `sol` / `bsc` / `base` (default `sol`) |
 | `--limit` | No | Page size (1–200, default 100) |
+| `--side` | No | Filter by trade direction: `buy` / `sell` (client-side filter) |
 
 ---
 
@@ -455,6 +471,69 @@ npx gmgn-cli swap \
 
 ---
 
+## multi-swap
+
+Submit token swaps across multiple wallets concurrently. Each wallet executes independently. Up to 100 wallets per request, all must be bound to the API Key. **Requires `GMGN_PRIVATE_KEY` configured in `.env`.**
+
+```bash
+gmgn-cli multi-swap \
+  --chain <chain> \
+  --accounts <addr1>,<addr2> \
+  --input-token <input_token_address> \
+  --output-token <output_token_address> \
+  [--input-amount <json>] \
+  [--input-amount-bps <json>] \
+  [--output-amount <json>] \
+  [--slippage <n>] \
+  [--auto-slippage] \
+  [--anti-mev] \
+  [--priority-fee <sol>] \
+  [--tip-fee <amount>] \
+  [--auto-tip-fee] \
+  [--max-auto-fee <amount>] \
+  [--gas-price <gwei>] \
+  [--max-fee-per-gas <amount>] \
+  [--max-priority-fee-per-gas <amount>] \
+  [--condition-orders <json>] \
+  [--sell-ratio-type <buy_amount|hold_amount>] \
+  [--raw]
+```
+
+| Option | Required | Description |
+|--------|----------|-------------|
+| `--chain` | Yes | `sol` / `bsc` / `base` |
+| `--accounts` | Yes | Comma-separated wallet addresses (1–100, all bound to API Key) |
+| `--input-token` | Yes | Input token contract address |
+| `--output-token` | Yes | Output token contract address |
+| `--input-amount` | No* | JSON map `{"addr":"amount"}` in smallest unit; one of the three amount fields is required |
+| `--input-amount-bps` | No* | JSON map `{"addr":"bps"}` where 5000 = 50%; only valid when input token is not a currency |
+| `--output-amount` | No* | JSON map `{"addr":"amount"}` target output in smallest unit |
+| `--slippage` | No | Slippage tolerance, e.g. `0.01` = 1% |
+| `--auto-slippage` | No | Enable automatic slippage |
+| `--anti-mev` | No | Enable anti-MEV protection |
+| `--priority-fee` | No | Priority fee in SOL (≥ 0.00001, SOL only) |
+| `--tip-fee` | No | Tip fee (SOL ≥ 0.00001 / BSC ≥ 0.000001 BNB) |
+| `--auto-tip-fee` | No | Enable automatic tip fee |
+| `--max-auto-fee` | No | Max automatic fee cap |
+| `--gas-price` | No | Gas price in gwei (BSC ≥ 0.05 / BASE/ETH ≥ 0.01) |
+| `--max-fee-per-gas` | No | EIP-1559 max fee per gas (Base only) |
+| `--max-priority-fee-per-gas` | No | EIP-1559 max priority fee per gas (Base only) |
+| `--condition-orders` | No | JSON array of take-profit/stop-loss conditions, attached to each successful wallet's swap (best-effort) |
+| `--sell-ratio-type` | No | Sell ratio base: `buy_amount` (default) / `hold_amount` |
+
+**Response fields (data):** Array of per-wallet results:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `account` | string | Wallet address |
+| `success` | bool | Whether this wallet's swap succeeded |
+| `error` | string | Error message on failure |
+| `error_code` | string | Error code on failure |
+| `result` | object | OrderResponse on success (same fields as `swap` response) |
+| `result.strategy_order_id` | string | Strategy order ID; only present when `--condition-orders` passed and strategy creation succeeded |
+
+---
+
 ## order get
 
 Query order status. **Requires `GMGN_PRIVATE_KEY` configured in `.env`.**

package-lock.json

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

package.json

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

skills/gmgn-portfolio/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: gmgn-portfolio
-description: Query GMGN wallet portfolio — API Key wallet info, holdings, transaction activity, trading stats, and token balance. Supports sol / bsc / base.
-argument-hint: "<info|holdings|activity|stats|token-balance> [--chain <sol|bsc|base>] [--wallet <wallet_address>]"
+description: Query GMGN wallet portfolio — API Key wallet info, holdings, transaction activity, trading stats, token balance, and developer-created tokens. Supports sol / bsc / base.
+argument-hint: "<info|holdings|activity|stats|token-balance|created-tokens> [--chain <sol|bsc|base>] [--wallet <wallet_address>]"
 metadata:
   cliHelp: "gmgn-cli portfolio --help"
 ---
@@ -39,6 +39,7 @@ Use the `gmgn-cli` tool to query wallet portfolio data based on the user's reque
 | `portfolio activity` | Transaction history |
 | `portfolio stats` | Trading statistics (supports batch) |
 | `portfolio token-balance` | Token balance for a specific token |
+| `portfolio created-tokens` | Tokens created by a developer wallet, with market cap and ATH info |
 
 ## Supported Chains
 
@@ -60,6 +61,7 @@ All portfolio routes used by this skill go through GMGN's leaky-bucket limiter w
 | `portfolio activity` | `GET /v1/user/wallet_activity` | 3 |
 | `portfolio stats` | `GET /v1/user/wallet_stats` | 3 |
 | `portfolio token-balance` | `GET /v1/user/wallet_token_balance` | 1 |
+| `portfolio created-tokens` | `GET /v1/user/created_tokens` | 2 |
 
 When a request returns `429`:
 
@@ -125,8 +127,28 @@ gmgn-cli portfolio stats --chain sol \
 # Token balance
 gmgn-cli portfolio token-balance \
   --chain sol --wallet <wallet_address> --token <token_address>
+
+# Tokens created by a developer wallet
+gmgn-cli portfolio created-tokens --chain sol --wallet <wallet_address>
+
+# Created tokens sorted by all-time high market cap
+gmgn-cli portfolio created-tokens \
+  --chain sol --wallet <wallet_address> \
+  --order-by token_ath_mc --direction desc
+
+# Only migrated tokens
+gmgn-cli portfolio created-tokens \
+  --chain sol --wallet <wallet_address> --migrate-state migrated
 ```
 
+## `portfolio created-tokens` Options
+
+| Option | Description |
+|--------|-------------|
+| `--order-by <field>` | Sort field: `market_cap` / `token_ath_mc` |
+| `--direction <asc\|desc>` | Sort direction (default `desc`) |
+| `--migrate-state <state>` | Filter by migration status: `migrated` (graduated to DEX) / `non_migrated` (still on bonding curve) |
+
 ## `portfolio holdings` Options
 
 | Option | Description |
@@ -228,12 +250,58 @@ The response also includes a `common` object when available (absent if the upstr
 | `common.follow_count` | Number of GMGN users following this wallet |
 | `common.remark_count` | Number of GMGN users who have remarked this wallet |
 | `common.created_token_count` | Tokens created by this wallet |
+| `common.created_at` | Wallet creation time (Unix seconds) — records when the first funding transaction arrived; use this as the wallet's age indicator |
 | `common.fund_from` | Funding source label |
 | `common.fund_from_address` | Address that funded this wallet |
 | `common.fund_amount` | Funding amount |
 
 Use `common.tags` and `common.twitter_username` when building a wallet profile narrative. If `common` is absent in the response, omit identity fields silently — do not report it as an error.
 
+### `portfolio created-tokens` — Key Fields
+
+The response `data` object has a `tokens` array plus aggregate stats.
+
+Top-level fields:
+
+| Field | Description |
+|-------|-------------|
+| `last_create_timestamp` | Unix timestamp of the most recent token creation |
+| `inner_count` | Number of tokens still on the bonding curve |
+| `open_count` | Number of tokens that have graduated to DEX |
+| `open_ratio` | Graduation rate (string, e.g. `"0.25"`) |
+| `creator_ath_info` | Best-performing token created by this wallet (ATH market cap) |
+| `tokens` | Array of created tokens — see below |
+
+`creator_ath_info` fields:
+
+| Field | Description |
+|-------|-------------|
+| `creator` | Wallet address |
+| `ath_token` | Token address with highest ATH market cap |
+| `ath_mc` | ATH market cap (USD string) |
+| `token_symbol` / `token_name` | Token ticker and name |
+| `token_logo` | Logo URL |
+
+Per-token fields (`tokens[*]`):
+
+| Field | Description |
+|-------|-------------|
+| `token_address` | Token contract address |
+| `symbol` | Token ticker |
+| `chain` | Chain name |
+| `create_timestamp` | Unix timestamp of creation |
+| `is_open` | `true` if graduated to DEX |
+| `market_cap` | Current market cap (USD string) |
+| `token_ath_mc` | All-time high market cap (USD string) |
+| `pool_liquidity` | Current liquidity (USD string) |
+| `holders` | Current holder count |
+| `swap_1h` | Swap count in the last hour |
+| `volume_1h` | Trading volume in the last hour (USD string) |
+| `launchpad_platform` | Launch platform name (e.g. `Pump.fun`) |
+| `is_pump` | `true` if launched on Pump.fun |
+| `bundler_rate` | Bundler participation rate (0–1) |
+| `cto_flag` | `true` if community-takeover token |
+
 **Do NOT guess field names not listed here.** If a field appears in the response but is not in this table, do not interpret it without reading the raw output first.
 
 ## Output Format

skills/gmgn-swap/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: gmgn-swap
 description: "[FINANCIAL EXECUTION] Submit a real blockchain token swap or query order status. Executes irreversible on-chain transactions. Requires explicit user confirmation before every swap. Supports sol / bsc / base."
-argument-hint: "[--chain <chain> --from <wallet> --input-token <addr> --output-token <addr> --amount <n>] | [order get --chain <chain> --order-id <id>]"
+argument-hint: "[--chain <chain> --from <wallet> --input-token <addr> --output-token <addr> --amount <n>] | [order get --chain <chain> --order-id <id>] | [order strategy list --chain <chain> --group-tag <LimitOrder|STMix>] | [order strategy create --chain <chain> --order-type limit_order --sub-order-type <buy_low|buy_high|stop_loss|take_profit> ...]"
 metadata:
   cliHelp: "gmgn-cli swap --help"
 ---
@@ -46,6 +46,7 @@ Use the `gmgn-cli` tool to submit a token swap or query an existing order. `GMGN
 | Sub-command | Description |
 |-------------|-------------|
 | `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 critical auth) |
 | `order get` | Query order status |
 | `order strategy create` | Create a limit/strategy order (requires private key) |
@@ -81,6 +82,7 @@ All swap-related routes used by this skill go through GMGN's leaky-bucket limite
 | Command | Route | Weight |
 |---------|-------|--------|
 | `swap` | `POST /v1/trade/swap` | 5 |
+| `multi-swap` | `POST /v1/trade/multi_swap` | 5 |
 | `order quote` | `GET /v1/trade/quote` | 2 |
 | `order get` | `GET /v1/trade/query_order` | 1 |
 
@@ -163,6 +165,79 @@ gmgn-cli swap \
   --percent 50
 ```
 
+## `multi-swap` Usage
+
+Submit a token swap across multiple wallets concurrently. Each wallet executes independently — one wallet's failure does not affect others. Up to 100 wallets per request. All wallets must be bound to the API Key. Requires `GMGN_PRIVATE_KEY`.
+
+```bash
+# Basic multi-wallet swap
+gmgn-cli multi-swap \
+  --chain sol \
+  --accounts <addr1>,<addr2> \
+  --input-token <input_token_address> \
+  --output-token <output_token_address> \
+  --input-amount '{"<addr1>":"1000000","<addr2>":"2000000"}' \
+  --slippage 0.01
+
+# Sell a percentage of each wallet's balance (use --input-amount-bps)
+gmgn-cli multi-swap \
+  --chain sol \
+  --accounts <addr1>,<addr2> \
+  --input-token <token_address> \
+  --output-token <sol_address> \
+  --input-amount-bps '{"<addr1>":"5000","<addr2>":"10000"}' \
+  --slippage 0.01
+
+# With per-wallet take-profit / stop-loss (condition_orders)
+gmgn-cli multi-swap \
+  --chain sol \
+  --accounts <addr1>,<addr2> \
+  --input-token So11111111111111111111111111111111111111112 \
+  --output-token <token_address> \
+  --input-amount '{"<addr1>":"1000000","<addr2>":"2000000"}' \
+  --slippage 0.3 \
+  --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"}]'
+```
+
+## `multi-swap` Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--chain` | Yes | `sol` / `bsc` / `base` |
+| `--accounts` | Yes | Comma-separated wallet addresses (1–100, all must be bound to the API Key) |
+| `--input-token` | Yes | Input token contract address |
+| `--output-token` | Yes | Output token contract address |
+| `--input-amount` | No* | 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* | JSON map of `wallet_address → percent in bps` (1–10000; 5000 = 50%). Only valid when `input_token` is NOT a currency. |
+| `--output-amount` | No* | JSON map of `wallet_address → target output amount` (smallest unit). |
+| `--slippage <n>` | No | Slippage tolerance, e.g. `0.01` = 1%. Mutually exclusive with `--auto-slippage`. |
+| `--auto-slippage` | No | Enable automatic slippage. |
+| `--anti-mev` | No | Enable anti-MEV protection. |
+| `--priority-fee <sol>` | No | Priority fee in SOL (≥ 0.00001, SOL only). Required when using `--condition-orders` on SOL. |
+| `--tip-fee <amount>` | No | Tip fee (SOL ≥ 0.00001 / BSC ≥ 0.000001 BNB). Required when using `--condition-orders` on SOL. |
+| `--auto-tip-fee` | No | Enable automatic tip fee. |
+| `--max-auto-fee <amount>` | No | Max automatic fee cap. |
+| `--gas-price <gwei>` | No | Gas price in gwei (BSC ≥ 0.05 / BASE/ETH ≥ 0.01). Required when using `--condition-orders` on BSC. |
+| `--max-fee-per-gas <amount>` | No | EIP-1559 max fee per gas (Base only). |
+| `--max-priority-fee-per-gas <amount>` | No | EIP-1559 max priority fee per gas (Base only). |
+| `--condition-orders <json>` | No | JSON array of condition sub-orders (take-profit / stop-loss) attached to each successful wallet's swap. Same structure as `swap --condition-orders`. Strategy creation is best-effort per wallet. |
+| `--sell-ratio-type <type>` | No | Sell ratio base for `--condition-orders`: `buy_amount` (default) / `hold_amount`. |
+
+## `multi-swap` Response Fields
+
+The response `data` is an array — one element per wallet:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `account` | string | Wallet address |
+| `success` | bool | Whether this wallet's swap succeeded |
+| `error` | string | Error message on failure; absent on success |
+| `error_code` | string | Error code on failure; absent on success |
+| `result` | object | On success: OrderResponse (same fields as `swap` response). On failure: absent. |
+| `result.strategy_order_id` | string | Strategy order ID; only present when `--condition-orders` was passed and strategy creation succeeded (best-effort) |
+
 ## `order quote` Usage
 
 Get an estimated output amount before submitting a swap. All supported quote chains use critical auth and require `GMGN_PRIVATE_KEY`.

skills/gmgn-token/SKILL.md

@@ -162,6 +162,15 @@ The response has five nested objects: `pool`, `dev`, `link`, `stat`, `wallet_tag
 | `open_timestamp` | Time the token opened for trading (Unix seconds) |
 | `biggest_pool_address` | Address of the main liquidity pool |
 | `og` | Whether the token is flagged as an OG token (`true` / `false`) |
+| `launchpad` | Launchpad identifier (e.g. `pump`, `moonshot`) |
+| `launchpad_status` | Launchpad state: `0` = not opened, `1` = live, `2` = migrated |
+| `launchpad_progress` | Launchpad bonding-curve progress (0–1) |
+| `launchpad_platform` | Launchpad platform name |
+| `migrated_pool` | Pool address after migration |
+| `migration_market_cap` | Market cap at migration time (USD, float) |
+| `migration_market_cap_quote` | Quote currency for `migration_market_cap` |
+| `ath_price` | All-time-high price (USD, float) |
+| `locked_ratio` | Ratio of supply locked (0–1, float) |
 
 **`pool` Object** — Main liquidity pool details
 
@@ -203,6 +212,13 @@ The response has five nested objects: `pool`, `dev`, `link`, `stat`, `wallet_tag
 | `dev.twitter_del_post_token_count` | Number of posts the creator deleted from Twitter |
 | `dev.twitter_create_token_count` | Number of tokens the creator has promoted on Twitter |
 | `dev.offchain` | Whether the token is an offchain token |
+| `dev.ath_token_info` | Creator's all-time-high token info object (optional); see sub-fields below |
+| `dev.ath_token_info.ath_token` | Contract address of the creator's best-performing token ever |
+| `dev.ath_token_info.ath_mc` | All-time-high market cap of that token (USD, string) |
+| `dev.ath_token_info.avatar` | Token logo URL |
+| `dev.ath_token_info.symbol` | Token symbol |
+| `dev.ath_token_info.name` | Token name |
+| `dev.ath_token_info.creation_timestamp` | Token creation time (Unix seconds) |
 
 **`link` Object** — Social and explorer links
 
@@ -237,6 +253,7 @@ The response has five nested objects: `pool`, `dev`, `link`, `stat`, `wallet_tag
 | `stat.bot_degen_count` | Number of bot degen wallets |
 | `stat.bot_degen_rate` | Ratio of bot degen wallets |
 | `stat.fresh_wallet_rate` | Ratio of fresh/new wallets among holders |
+| `stat.private_vault_hold_rate` | Ratio held by private vault (vanish) addresses — displayed as "vanish" in GMGN UI (0–1) |
 
 **`wallet_tags_stat` Object** — Wallet type breakdown
 

skills/gmgn-track/SKILL.md

@@ -16,7 +16,7 @@ Use the `gmgn-cli` tool to query on-chain tracking data based on the user's requ
 
 ## Core Concepts
 
-- **`follow-wallet` vs `kol` vs `smartmoney`** — Three distinct data sources. `follow-wallet` returns trades from wallets the user has personally followed on the GMGN platform (user-specific, requires private key). `kol` and `smartmoney` return trades from platform-tagged public wallet lists (not user-specific, API Key only). Never substitute one for another.
+- **`follow-wallet` vs `kol` vs `smartmoney`** — Three distinct data sources. `follow-wallet` returns trades from wallets the user has personally followed on the GMGN platform (user-specific; the follow list is resolved from the GMGN user account bound to the API Key). `kol` and `smartmoney` return trades from platform-tagged public wallet lists (not user-specific). Never substitute one for another.
 
 - **KOL (Key Opinion Leader)** — Wallets publicly identified as influencers or well-known traders on GMGN. Tagged as `renowned` in the platform's wallet label system. Their trades carry social/marketing signal, not necessarily alpha.
 
@@ -60,8 +60,7 @@ Use the `gmgn-cli` tool to query on-chain tracking data based on the user's requ
 ## Prerequisites
 
 - `gmgn-cli` installed globally — if missing, run: `npm install -g gmgn-cli`
-- `GMGN_API_KEY` configured in `~/.config/gmgn/.env`
-- `GMGN_PRIVATE_KEY` required only for `track follow-wallet`; not needed for `track kol` / `track smartmoney`
+- `GMGN_API_KEY` configured in `~/.config/gmgn/.env` — required for all sub-commands; no private key needed
 
 ## Rate Limit Handling
 
@@ -95,10 +94,6 @@ When a request returns `429`:
    echo 'GMGN_API_KEY=<key_from_user>' > ~/.config/gmgn/.env
    chmod 600 ~/.config/gmgn/.env
    ```
-   If the user also needs `track follow-wallet`, append the private key:
-   ```bash
-   echo 'GMGN_PRIVATE_KEY="<pem_content_from_step_1>"' >> ~/.config/gmgn/.env
-   ```
 
 ## Usage Examples
 
@@ -308,13 +303,12 @@ To research any token surfaced by smart money activity, follow [`docs/workflow-t
 
 ## Safety Constraints
 
-- **`track follow-wallet` requires `GMGN_PRIVATE_KEY`** — this signing key is linked to your GMGN account. It is used for authentication only (no on-chain access), but must be protected like any credential. Never expose it in logs or command output.
 - **`follow-wallet` reveals your following list** — results expose which wallets you have followed on GMGN. Do not share raw output in public channels.
 - **`track kol` / `track smartmoney` expose no personal data** — these use API Key auth only and return platform-tagged public wallet activity. Safe to share raw output.
 
 ## Notes
 
-- `track kol` / `track smartmoney` use normal auth (API Key only, no signature required)
-- `track follow-wallet` requires `GMGN_PRIVATE_KEY` for signature auth — and wallets must be followed via the GMGN platform first
+- All sub-commands use normal auth (API Key only, no signature required)
+- `track follow-wallet` returns trades from wallets followed on the GMGN platform; the follow list is resolved automatically from the GMGN user account bound to the API Key — `--wallet` is optional
 - Use `--raw` to get single-line JSON for further processing
 - `track kol` / `track smartmoney` `--side` is a **client-side filter** — the CLI fetches all results then filters locally; it is NOT sent to the API

src/client/OpenApiClient.ts

@@ -97,6 +97,29 @@ export interface StrategyConditionOrder {
   drawdown_rate?: string;
 }
 
+export interface MultiSwapParams {
+  chain: string;
+  accounts: string[];
+  input_token: string;
+  output_token: string;
+  input_amount?: Record<string, string>;
+  input_amount_bps?: Record<string, string>;
+  output_amount?: Record<string, string>;
+  swap_mode?: string;
+  slippage?: number;
+  auto_slippage?: boolean;
+  is_anti_mev?: boolean;
+  priority_fee?: string;
+  tip_fee?: string;
+  auto_tip_fee?: boolean;
+  max_auto_fee?: string;
+  gas_price?: string;
+  max_fee_per_gas?: string;
+  max_priority_fee_per_gas?: string;
+  condition_orders?: StrategyConditionOrder[];
+  sell_ratio_type?: string;
+}
+
 export interface StrategyCreateParams {
   chain: string;
   from_address: string;
@@ -268,7 +291,7 @@ export class OpenApiClient {
   }
 
   async getFollowWallet(chain: string, extra: Record<string, string | number | string[]> = {}): Promise<unknown> {
-    return this.criticalRequest("GET", "/v1/trade/follow_wallet", { chain, ...extra }, null);
+    return this.normalRequest("GET", "/v1/trade/follow_wallet", { chain, ...extra });
   }
 
   async getKol(chain?: string, limit?: number): Promise<unknown> {
@@ -285,6 +308,10 @@ export class OpenApiClient {
     return this.normalRequest("GET", "/v1/user/smartmoney", query);
   }
 
+  async getCreatedTokens(chain: string, walletAddress: string, extra: Record<string, string | number> = {}): Promise<unknown> {
+    return this.normalRequest("GET", "/v1/user/created_tokens", { chain, wallet_address: walletAddress, ...extra });
+  }
+
   async quoteOrder(
     chain: string,
     from_address: string,
@@ -303,6 +330,10 @@ export class OpenApiClient {
     return this.criticalRequest("POST", "/v1/trade/swap", {}, params);
   }
 
+  async multiSwap(params: MultiSwapParams): Promise<unknown> {
+    return this.criticalRequest("POST", "/v1/trade/multi_swap", {}, params);
+  }
+
   async queryOrder(orderId: string, chain: string): Promise<unknown> {
     return this.criticalRequest("GET", "/v1/trade/query_order", { order_id: orderId, chain }, null);
   }

src/commands/portfolio.ts

@@ -109,5 +109,26 @@ export function registerPortfolioCommands(program: Command): void {
       printResult(data, opts.raw);
     });
 
+  portfolio
+    .command("created-tokens")
+    .description("Get tokens created by a developer wallet")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--wallet <address>", "Developer wallet address")
+    .option("--order-by <field>", "Sort field: market_cap / token_ath_mc")
+    .option("--direction <dir>", "Sort direction: asc / desc")
+    .option("--migrate-state <state>", "Filter: migrated / non_migrated")
+    .option("--raw", "Output raw JSON")
+    .action(async (opts) => {
+      validateChain(opts.chain);
+      validateAddress(opts.wallet, opts.chain, "--wallet");
+      const extra: Record<string, string | number> = {};
+      if (opts.orderBy) extra["order_by"] = opts.orderBy;
+      if (opts.direction) extra["direction"] = opts.direction;
+      if (opts.migrateState) extra["migrate_state"] = opts.migrateState;
+      const client = new OpenApiClient(getConfig());
+      const data = await client.getCreatedTokens(opts.chain, opts.wallet, extra).catch(exitOnError);
+      printResult(data, opts.raw);
+    });
+
 }
 

src/commands/swap.ts

@@ -1,5 +1,5 @@
 import { Command } from "commander";
-import { OpenApiClient, SwapParams, StrategyCreateParams, StrategyCancelParams } from "../client/OpenApiClient.js";
+import { OpenApiClient, SwapParams, MultiSwapParams, StrategyCreateParams, StrategyCancelParams } from "../client/OpenApiClient.js";
 import { getConfig } from "../config.js";
 import { exitOnError, printResult } from "../output.js";
 import { validateAddress, validateChain, validatePercent, validatePositiveInt } from "../validate.js";
@@ -109,6 +109,78 @@ export function registerSwapCommands(program: Command): void {
       printResult(data, opts.raw);
     });
 
+  program
+    .command("multi-swap")
+    .description("Submit token swaps across multiple wallets concurrently (up to 100 wallets)")
+    .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+    .requiredOption("--accounts <addresses>", "Comma-separated wallet addresses (all must be bound to the API Key)")
+    .requiredOption("--input-token <address>", "Input token contract address")
+    .requiredOption("--output-token <address>", "Output token contract address")
+    .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("--auto-slippage", "Enable automatic slippage")
+    .option("--anti-mev", "Enable anti-MEV protection")
+    .option("--priority-fee <sol>", "Priority fee in SOL (SOL only, ≥ 0.00001)")
+    .option("--tip-fee <amount>", "Tip fee (SOL ≥ 0.00001 / BSC ≥ 0.000001 BNB)")
+    .option("--auto-tip-fee", "Enable automatic tip fee")
+    .option("--max-auto-fee <amount>", "Max auto fee cap")
+    .option("--gas-price <gwei>", "Gas price in gwei (BSC ≥ 0.05 / BASE/ETH ≥ 0.01)")
+    .option("--max-fee-per-gas <amount>", "EIP-1559 max fee per gas (Base only)")
+    .option("--max-priority-fee-per-gas <amount>", "EIP-1559 max priority fee per gas (Base only)")
+    .option("--condition-orders <json>", "JSON array of take-profit/stop-loss conditions attached to each successful wallet's swap")
+    .option("--sell-ratio-type <type>", "Sell ratio base: buy_amount (default) / hold_amount; only used with --condition-orders")
+    .option("--raw", "Output raw JSON")
+    .action(async (opts) => {
+      if (!opts.inputAmount && !opts.inputAmountBps && !opts.outputAmount) {
+        console.error("[gmgn-cli] At least one of --input-amount, --input-amount-bps, or --output-amount must be provided");
+        process.exit(1);
+      }
+      validateChain(opts.chain);
+      const accounts = (opts.accounts as string).split(",").map((a: string) => a.trim()).filter(Boolean);
+      if (accounts.length === 0 || accounts.length > 100) {
+        console.error("[gmgn-cli] --accounts must be 1–100 comma-separated wallet addresses");
+        process.exit(1);
+      }
+      const params: MultiSwapParams = {
+        chain: opts.chain,
+        accounts,
+        input_token: opts.inputToken,
+        output_token: opts.outputToken,
+      };
+      if (opts.inputAmount) {
+        try { params.input_amount = JSON.parse(opts.inputAmount); }
+        catch { console.error("[gmgn-cli] --input-amount must be valid JSON"); process.exit(1); }
+      }
+      if (opts.inputAmountBps) {
+        try { params.input_amount_bps = JSON.parse(opts.inputAmountBps); }
+        catch { console.error("[gmgn-cli] --input-amount-bps must be valid JSON"); process.exit(1); }
+      }
+      if (opts.outputAmount) {
+        try { params.output_amount = JSON.parse(opts.outputAmount); }
+        catch { console.error("[gmgn-cli] --output-amount must be valid JSON"); process.exit(1); }
+      }
+      if (opts.slippage != null) params.slippage = opts.slippage;
+      if (opts.autoSlippage) params.auto_slippage = true;
+      if (opts.antiMev) params.is_anti_mev = true;
+      if (opts.priorityFee) params.priority_fee = opts.priorityFee;
+      if (opts.tipFee) params.tip_fee = opts.tipFee;
+      if (opts.autoTipFee) params.auto_tip_fee = true;
+      if (opts.maxAutoFee) params.max_auto_fee = opts.maxAutoFee;
+      if (opts.gasPrice) params.gas_price = String(Math.round(parseFloat(opts.gasPrice) * 1e9));
+      if (opts.maxFeePerGas) params.max_fee_per_gas = opts.maxFeePerGas;
+      if (opts.maxPriorityFeePerGas) params.max_priority_fee_per_gas = opts.maxPriorityFeePerGas;
+      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.sellRatioType) params.sell_ratio_type = opts.sellRatioType;
+      const client = new OpenApiClient(getConfig(true));
+      const data = await client.multiSwap(params).catch(exitOnError);
+      printResult(data, opts.raw);
+    });
+
   const strategy = order.command("strategy").description("Limit/strategy order management");
 
   strategy

src/commands/track.ts

@@ -27,7 +27,7 @@ export function registerTrackCommands(program: Command): void {
       if (opts.filter?.length) extra["filters"] = opts.filter;
       if (opts.minAmountUsd != null) extra["min_amount_usd"] = opts.minAmountUsd;
       if (opts.maxAmountUsd != null) extra["max_amount_usd"] = opts.maxAmountUsd;
-      const client = new OpenApiClient(getConfig(true));
+      const client = new OpenApiClient(getConfig());
       const data = await client.getFollowWallet(opts.chain, extra).catch(exitOnError);
       printResult(data, opts.raw);
     });