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 gmgn-cli installed globally: npm install -g gmgn-cli@1.0.1 Usage Examples

API Key wallet info (no --chain or --wallet needed)

gmgn-cli portfolio info

Wallet holdings (default sort)

gmgn-cli portfolio holdings --chain sol --wallet < wallet_address

Holdings sorted by USD value, descending

gmgn-cli portfolio holdings \ --chain sol --wallet < wallet_address

\ --order-by usd_value --direction desc --limit 20

Include sold-out positions

gmgn-cli portfolio holdings --chain sol --wallet < wallet_address

--sell-out

Transaction activity

gmgn-cli portfolio activity --chain sol --wallet < wallet_address

Activity filtered by type

gmgn-cli portfolio activity --chain sol --wallet < wallet_address

\ --type buy --type sell

Activity for a specific token

gmgn-cli portfolio activity --chain sol --wallet < wallet_address

\ --token < token_address

Trading stats (default 7d)

gmgn-cli portfolio stats --chain sol --wallet < wallet_address

Trading stats for 30 days

gmgn-cli portfolio stats --chain sol --wallet < wallet_address

--period 30d

Batch stats for multiple wallets

gmgn-cli portfolio stats --chain sol \ --wallet < wallet_ 1

--wallet < wallet_ 2

Token balance

gmgn-cli portfolio token-balance \ --chain sol --wallet < wallet_address

--token < token_address

Holdings Options Option Description --limit Page size (default 20 , max 50) --cursor Pagination cursor --order-by Sort field: usd_value / price / unrealized_profit / realized_profit / total_profit / history_bought_cost / history_sold_income (default usd_value ) --direction 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

Filter by token --limit Page size --cursor Pagination cursor --type Repeatable: buy / sell / add / remove / transfer Stats Options Option Description --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 Input validation — Wallet and token addresses are validated against the expected chain format at runtime (sol: base58 32–44 chars; bsc/base/eth: 0x + 40 hex digits). The CLI exits with an error on invalid input.