gmgn-cli 1.0.0

package/dist/commands/token.js

@@ -0,0 +1,62 @@
+import { OpenApiClient } from "../client/OpenApiClient.js";
+import { getConfig } from "../config.js";
+import { exitOnError, printResult } from "../output.js";
+export function registerTokenCommands(program) {
+    const token = program.command("token").description("Token information commands");
+    token
+        .command("info")
+        .description("Get token basic information and realtime price")
+        .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+        .requiredOption("--address <address>", "Token contract address")
+        .option("--raw", "Output raw JSON")
+        .action(async (opts) => {
+        const client = new OpenApiClient(getConfig());
+        const data = await client.getTokenInfo(opts.chain, opts.address).catch(exitOnError);
+        printResult(data, opts.raw);
+    });
+    token
+        .command("security")
+        .description("Get token security metrics")
+        .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+        .requiredOption("--address <address>", "Token contract address")
+        .option("--raw", "Output raw JSON")
+        .action(async (opts) => {
+        const client = new OpenApiClient(getConfig());
+        const data = await client.getTokenSecurity(opts.chain, opts.address).catch(exitOnError);
+        printResult(data, opts.raw);
+    });
+    token
+        .command("pool")
+        .description("Get token liquidity pool information")
+        .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+        .requiredOption("--address <address>", "Token contract address")
+        .option("--raw", "Output raw JSON")
+        .action(async (opts) => {
+        const client = new OpenApiClient(getConfig());
+        const data = await client.getTokenPoolInfo(opts.chain, opts.address).catch(exitOnError);
+        printResult(data, opts.raw);
+    });
+    token
+        .command("holders")
+        .description("Get top token holders")
+        .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+        .requiredOption("--address <address>", "Token contract address")
+        .option("--raw", "Output raw JSON")
+        .action(async (opts) => {
+        const client = new OpenApiClient(getConfig());
+        const data = await client.getTokenTopHolders(opts.chain, opts.address).catch(exitOnError);
+        printResult(data, opts.raw);
+    });
+    token
+        .command("traders")
+        .description("Get top token traders")
+        .requiredOption("--chain <chain>", "Chain: sol / bsc / base")
+        .requiredOption("--address <address>", "Token contract address")
+        .option("--raw", "Output raw JSON")
+        .action(async (opts) => {
+        const client = new OpenApiClient(getConfig());
+        const data = await client.getTokenTopTraders(opts.chain, opts.address).catch(exitOnError);
+        printResult(data, opts.raw);
+    });
+}
+//# sourceMappingURL=token.js.map

package/dist/commands/token.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+export interface Config {
+    apiKey: string;
+    privateKeyPem?: string;
+    host: string;
+}
+export declare function getConfig(requirePrivateKey?: boolean): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAID,wBAAgB,SAAS,CAAC,iBAAiB,UAAQ,GAAG,MAAM,CAyB3D"}

package/dist/config.js

@@ -0,0 +1,36 @@
+import { config as loadDotenv } from "dotenv";
+import { homedir } from "os";
+import { join } from "path";
+// Load global config first (~/.config/gmgn/.env), then project .env (project takes precedence)
+loadDotenv({ path: join(homedir(), ".config", "gmgn", ".env") });
+loadDotenv({ override: true });
+let _config = null;
+export function getConfig(requirePrivateKey = false) {
+    if (_config) {
+        if (requirePrivateKey && !_config.privateKeyPem) {
+            die("GMGN_PRIVATE_KEY is required for swap/order commands");
+        }
+        return _config;
+    }
+    const apiKey = process.env.GMGN_API_KEY;
+    if (!apiKey) {
+        die("GMGN_API_KEY is required. Set it in your .env file or environment.");
+    }
+    let privateKeyPem;
+    const privateKey = process.env.GMGN_PRIVATE_KEY;
+    if (privateKey) {
+        // Support escaped newlines (e.g. from single-line .env values)
+        privateKeyPem = privateKey.replace(/\\n/g, "\n");
+    }
+    else if (requirePrivateKey) {
+        die("GMGN_PRIVATE_KEY is required for swap/order commands");
+    }
+    const host = process.env.GMGN_HOST ?? "https://openapi.gmgn.ai";
+    _config = { apiKey: apiKey, privateKeyPem, host };
+    return _config;
+}
+function die(msg) {
+    console.error(`[gmgn-cli] Error: ${msg}`);
+    process.exit(1);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,+FAA+F;AAC/F,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AACjE,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAQ/B,IAAI,OAAO,GAAkB,IAAI,CAAC;AAElC,MAAM,UAAU,SAAS,CAAC,iBAAiB,GAAG,KAAK;IACjD,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,iBAAiB,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAChD,GAAG,CAAC,sDAAsD,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,GAAG,CAAC,oEAAoE,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,aAAiC,CAAC;IACtC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAChD,IAAI,UAAU,EAAE,CAAC;QACf,+DAA+D;QAC/D,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnD,CAAC;SAAM,IAAI,iBAAiB,EAAE,CAAC;QAC7B,GAAG,CAAC,sDAAsD,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,yBAAyB,CAAC;IAChE,OAAO,GAAG,EAAE,MAAM,EAAE,MAAO,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IACnD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,GAAG,CAAC,GAAW;IACtB,OAAO,CAAC,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import { setGlobalDispatcher, ProxyAgent, Agent } from "undici";
+import { SocksClient } from "socks";
+import * as tls from "tls";
+import { Command } from "commander";
+import { registerTokenCommands } from "./commands/token.js";
+import { registerMarketCommands } from "./commands/market.js";
+import { registerPortfolioCommands } from "./commands/portfolio.js";
+import { registerSwapCommands } from "./commands/swap.js";
+const proxy = process.env.HTTPS_PROXY ?? process.env.https_proxy
+    ?? process.env.HTTP_PROXY ?? process.env.http_proxy;
+if (proxy) {
+    const u = new URL(proxy);
+    if (u.protocol === "socks5:" || u.protocol === "socks4:") {
+        const type = u.protocol === "socks5:" ? 5 : 4;
+        setGlobalDispatcher(new Agent({
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            connect: async (options, callback) => {
+                try {
+                    const { socket } = await SocksClient.createConnection({
+                        proxy: { host: u.hostname, port: parseInt(u.port || "1080"), type },
+                        command: "connect",
+                        destination: { host: options.hostname, port: +options.port },
+                    });
+                    if (options.protocol === "https:") {
+                        callback(null, tls.connect({ socket, servername: options.hostname, rejectUnauthorized: options.rejectUnauthorized !== false }));
+                    }
+                    else {
+                        callback(null, socket);
+                    }
+                }
+                catch (err) {
+                    callback(err, null);
+                }
+            },
+        }));
+    }
+    else {
+        setGlobalDispatcher(new ProxyAgent(proxy));
+    }
+}
+const program = new Command();
+program
+    .name("gmgn-cli")
+    .version("1.0.0")
+    .description("GMGN OpenAPI CLI — market data, token info, portfolio and swap");
+registerTokenCommands(program);
+registerMarketCommands(program);
+registerPortfolioCommands(program);
+registerSwapCommands(program);
+program.parseAsync().catch((err) => {
+    console.error(`[gmgn-cli] ${err.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/output.d.ts

@@ -0,0 +1,3 @@
+export declare function printResult(data: unknown, raw?: boolean): void;
+export declare function exitOnError(err: Error): never;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,CAM9D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,KAAK,GAAG,KAAK,CAY7C"}

package/dist/output.js

@@ -0,0 +1,22 @@
+export function printResult(data, raw) {
+    if (raw) {
+        console.log(JSON.stringify(data));
+    }
+    else {
+        console.log(JSON.stringify(data, null, 2));
+    }
+}
+export function exitOnError(err) {
+    console.error(`[gmgn-cli] ${err.message}`);
+    if (process.env.GMGN_DEBUG) {
+        if (err.code) {
+            console.error(`[gmgn-cli] code: ${err.code}`);
+        }
+        if (err.cause) {
+            console.error(`[gmgn-cli] cause: ${err.cause}`);
+        }
+        console.error(err.stack ?? "");
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,GAAa;IACtD,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAU;IACpC,OAAO,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3C,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;QAC3B,IAAK,GAA6B,CAAC,IAAI,EAAE,CAAC;YACxC,OAAO,CAAC,KAAK,CAAC,oBAAqB,GAA6B,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,IAAK,GAA2B,CAAC,KAAK,EAAE,CAAC;YACvC,OAAO,CAAC,KAAK,CAAC,qBAAsB,GAA2B,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "gmgn-cli",
+  "version": "1.0.0",
+  "description": "GMGN OpenAPI CLI — call GMGN market, token, portfolio and swap APIs from the command line",
+  "type": "module",
+  "bin": {
+    "gmgn-cli": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "skills",
+    ".claude-plugin",
+    ".cursor-plugin"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+"prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "dotenv": "^16.4.5",
+    "socks": "^2.8.7",
+    "undici": "^7.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gmgn-ai/gmgn-skills"
+  },
+  "keywords": [
+    "gmgn",
+    "crypto",
+    "solana",
+    "token",
+    "defi",
+    "swap",
+    "portfolio",
+    "market",
+    "claude-skill"
+  ]
+}

package/skills/gmgn-market/SKILL.md

@@ -0,0 +1,144 @@
+---
+name: gmgn-market
+description: Query GMGN market data — token K-line (candlestick) and trending token swap data. Supports sol / bsc / base.
+argument-hint: "kline --chain <sol|bsc|base> --address <token_address> --resolution <1m|5m|15m|1h|4h|1d> [--from <unix_ts>] [--to <unix_ts>] | trending --chain <sol|bsc|base> --interval <1h|3h|6h|24h>"
+---
+
+Use the `gmgn-cli` tool to query K-line data for a token or browse trending tokens.
+
+## Sub-commands
+
+| Sub-command | Description |
+|-------------|-------------|
+| `market kline` | Token candlestick data |
+| `market trending` | Trending token swap data |
+
+## Supported Chains
+
+`sol` / `bsc` / `base`
+
+## Prerequisites
+
+- `.env` file with `GMGN_API_KEY` set
+- Run from the directory where your `.env` file is located, or set `GMGN_HOST` in your environment
+
+## Kline Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--chain` | Yes | `sol` / `bsc` / `base` |
+| `--address` | Yes | Token contract address |
+| `--resolution` | Yes | Candlestick resolution |
+| `--from` | No | Start time (Unix seconds) |
+| `--to` | No | End time (Unix seconds) |
+
+## Resolutions
+
+`1m` / `5m` / `15m` / `1h` / `4h` / `1d`
+
+## Trending Options
+
+| Option | Description |
+|--------|-------------|
+| `--chain` | Required. `sol` / `bsc` / `base` |
+| `--interval` | Required. `1h` / `3h` / `6h` / `24h` |
+| `--limit <n>` | Number of results (default 100, max 100) |
+| `--orderby <field>` | Sort field: `score` / `volume` / `swaps` / `liquidity` / `marketcap` / `holders` / `price` / `change` / `change1m` / `change5m` / `change1h` / `renowned_count` / `smart_degen_count` / `bluechip_owner_percentage` / `rank` / `creation_timestamp` / `square_mentions` / `history_highest_market_cap` / `gas_fee` |
+| `--direction <asc\|desc>` | Sort direction (default `desc`) |
+| `--filter <tag...>` | Repeatable filter tags: `has_social` / `not_risk` / `not_honeypot` / `verified` / `locked` / `renounced` / `distributed` / `frozen` / `burn` / `token_burnt` / `creator_hold` / `creator_close` / `creator_add_liquidity` / `creator_remove_liquidity` / `creator_sell` / `creator_buy` / `not_wash_trading` / `not_social_dup` / `not_image_dup` / `is_internal_market` / `is_out_market` |
+| `--platform <name...>` | Repeatable platform filter: `pump` / `moonshot` / `launchlab` |
+
+## Usage Examples
+
+```bash
+# Last 1 hour of 1-minute candles
+# macOS:
+npx gmgn-cli market kline \
+  --chain sol \
+  --address <token_address> \
+  --resolution 1m \
+  --from $(date -v-1H +%s) \
+  --to $(date +%s)
+# Linux: use $(date -d '1 hour ago' +%s) instead of $(date -v-1H +%s)
+
+# Last 24 hours of 1-hour candles
+# macOS:
+npx gmgn-cli market kline \
+  --chain sol \
+  --address <token_address> \
+  --resolution 1h \
+  --from $(date -v-24H +%s) \
+  --to $(date +%s)
+# Linux: use $(date -d '24 hours ago' +%s) instead of $(date -v-24H +%s)
+
+# Top 20 hot tokens on SOL in the last 1 hour, sorted by volume
+npx gmgn-cli market trending --chain sol --interval 1h --orderby volume --limit 20
+
+# Hot tokens with social links only, not risky, on BSC over 24h
+npx gmgn-cli market trending \
+  --chain bsc --interval 24h \
+  --filter has_social --filter not_risk
+
+# Pump platform tokens on SOL, last 6 hours
+npx gmgn-cli market trending --chain sol --interval 6h --platform pump
+
+# Raw output for further processing
+npx gmgn-cli market kline --chain sol --address <addr> \
+  --resolution 5m --from <ts> --to <ts> --raw | jq '.[]'
+```
+
+## Workflow: Discover Trading Opportunities via Trending
+
+### Step 1 — Fetch trending data
+
+Fetch a broad pool with safe filters, sorted by GMGN's composite score:
+
+```bash
+npx gmgn-cli market trending \
+  --chain <chain> --interval 1h \
+  --orderby score --limit 50 \
+  --filter not_risk --filter not_honeypot --filter has_social --raw
+```
+
+### Step 2 — AI multi-factor analysis
+
+Analyze each record in the response using the following signals (apply judgment, not rigid rules):
+
+| Signal | Field(s) | Weight | Notes |
+|--------|----------|--------|-------|
+| GMGN quality score | `score` | High | Primary ranking signal from GMGN |
+| Smart money interest | `smart_degen_count`, `renowned_count` | High | Key conviction indicator |
+| Bluechip ownership | `bluechip_owner_percentage` | Medium | Quality of holder base |
+| Real trading activity | `volume`, `swaps` | Medium | Distinguishes genuine interest from wash trading |
+| Price momentum | `change1h`, `change5m` | Medium | Prefer positive, non-parabolic moves |
+| Pool safety | `liquidity` | Medium | Low liquidity = high slippage risk |
+| Token maturity | `creation_timestamp` | Low | Avoid tokens less than ~1h old unless other signals are very strong |
+
+Select the **top 5** tokens with the best composite profile. Prefer tokens that score well across multiple signals rather than excelling in just one.
+
+### Step 3 — Present top 5 to user
+
+Present results as a concise table, then give a one-line rationale for each pick:
+
+```
+Top 5 Trending Tokens — SOL / 1h
+
+# | Symbol | Address (short) | Score | Smart Degens | Volume | 1h Chg | Reasoning
+1 | ...     | ...             | ...   | ...          | ...    | ...    | High score + smart money accumulating
+2 | ...
+...
+```
+
+### Step 4 — Follow-up actions
+
+For each token, offer:
+- **Deep dive**: `token info` + `token security` for full due diligence
+- **Swap**: execute directly if the user is satisfied with the trending data alone
+
+## Notes
+
+- `market kline`: `--from` and `--to` are Unix timestamps in **seconds** — CLI converts to milliseconds automatically
+- `market trending`: `--filter` and `--platform` are repeatable flags
+- All commands use normal auth (API Key only, no signature)
+- If the user doesn't provide kline timestamps, calculate them from the current time based on their desired time range
+- Use `--raw` to get single-line JSON for further processing

package/skills/gmgn-portfolio/SKILL.md

@@ -0,0 +1,105 @@
+---
+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>]"
+---
+
+Use the `gmgn-cli` tool to query wallet portfolio data based on the user's request.
+
+## Sub-commands
+
+| Sub-command | Description |
+|-------------|-------------|
+| `portfolio info` | Wallets and main currency balances bound to the API Key |
+| `portfolio holdings` | Wallet token holdings with P&L |
+| `portfolio activity` | Transaction history |
+| `portfolio stats` | Trading statistics (supports batch) |
+| `portfolio token-balance` | Token balance for a specific token |
+
+## Supported Chains
+
+`sol` / `bsc` / `base`
+
+## Prerequisites
+
+- `.env` file with `GMGN_API_KEY` set
+- Run from the directory where your `.env` file is located, or set `GMGN_HOST` in your environment
+
+## Usage Examples
+
+```bash
+# API Key wallet info (no --chain or --wallet needed)
+npx gmgn-cli portfolio info
+
+# Wallet holdings (default sort)
+npx gmgn-cli portfolio holdings --chain sol --wallet <wallet_address>
+
+# Holdings sorted by USD value, descending
+npx gmgn-cli portfolio holdings \
+  --chain sol --wallet <wallet_address> \
+  --order-by usd_value --direction desc --limit 20
+
+# Include sold-out positions
+npx gmgn-cli portfolio holdings --chain sol --wallet <wallet_address> --sell-out
+
+# Transaction activity
+npx gmgn-cli portfolio activity --chain sol --wallet <wallet_address>
+
+# Activity filtered by type
+npx gmgn-cli portfolio activity --chain sol --wallet <wallet_address> \
+  --type buy --type sell
+
+# Activity for a specific token
+npx gmgn-cli portfolio activity --chain sol --wallet <wallet_address> \
+  --token <token_address>
+
+# Trading stats (default 7d)
+npx gmgn-cli portfolio stats --chain sol --wallet <wallet_address>
+
+# Trading stats for 30 days
+npx gmgn-cli portfolio stats --chain sol --wallet <wallet_address> --period 30d
+
+# Batch stats for multiple wallets
+npx gmgn-cli portfolio stats --chain sol \
+  --wallet <wallet_1> --wallet <wallet_2>
+
+# Token balance
+npx gmgn-cli portfolio token-balance \
+  --chain sol --wallet <wallet_address> --token <token_address>
+```
+
+## Holdings Options
+
+| Option | Description |
+|--------|-------------|
+| `--limit <n>` | Page size (default `20`, max 50) |
+| `--cursor <cursor>` | Pagination cursor |
+| `--order-by <field>` | Sort field: `usd_value` / `price` / `unrealized_profit` / `realized_profit` / `total_profit` / `history_bought_cost` / `history_sold_income` (default `usd_value`) |
+| `--direction <asc\|desc>` | Sort direction (default `desc`) |
+| `--sell-out` | Include sold-out positions |
+| `--show-small` | Include small-value positions |
+| `--hide-abnormal` | Hide abnormal positions |
+| `--hide-airdrop` | Hide airdrop positions |
+| `--hide-closed` | Hide closed positions |
+| `--hide-open` | Hide open positions |
+
+## Activity Options
+
+| Option | Description |
+|--------|-------------|
+| `--token <address>` | Filter by token |
+| `--limit <n>` | Page size |
+| `--cursor <cursor>` | Pagination cursor |
+| `--type <type>` | Repeatable: `buy` / `sell` / `add` / `remove` / `transfer` |
+
+## Stats Options
+
+| Option | Description |
+|--------|-------------|
+| `--period <period>` | Stats period: `7d` / `30d` (default `7d`) |
+
+## Notes
+
+- All portfolio commands use normal auth (API Key only, no signature required)
+- `portfolio stats` supports multiple `--wallet` flags for batch queries
+- Use `--raw` to get single-line JSON for further processing