---
id: daily-gmgn-portfolio
name: "gmgn-portfolio"
url: https://skills.yangsir.net/skill/daily-gmgn-portfolio
author: gmgnai
domain: investment
tags: ["portfolio-management", "pnl-tracking", "wallet-analysis", "trading-history", "investment"]
install_count: 4500
rating: 4.40 (20 reviews)
github: https://github.com/gmgnai/gmgn-skills
---

# gmgn-portfolio

> 查询钱包资产组合、代币持仓盈亏和交易历史，追踪投资表现和资金流向

**Stats**: 4,500 installs · 4.4/5 (20 reviews)

## Before / After 对比

### 投资组合追踪

**Before**:

手动记录每个钱包的持仓和成本，计算盈亏需要导出表格手动计算，耗时且易错

**After**:

自动聚合所有钱包资产，实时计算盈亏，交易历史自动归类，投资表现一目了然

| Metric | Before | After | Change |
|---|---|---|---|
| 记账时间 | 60min/day | 5min/day | -92% |

## Readme

# gmgn-portfolio

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 <n>`
Page size (default `20`, max 50)

`--cursor <cursor>`
Pagination cursor

`--order-by <field>`
Sort field: `usd_value` / `last_active_timestamp` / `realized_profit` / `unrealized_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 (pass the `next` value from the previous response)

`--type <type>`
Repeatable: `buy` / `sell` / `add` / `remove` / `transfer`

The activity response includes a `next` field. Pass it to `--cursor` to fetch the next page.

## 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

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

Weekly Installs234Repository[gmgnai/gmgn-skills](https://github.com/gmgnai/gmgn-skills)GitHub Stars22First Seen5 days agoSecurity Audits[Gen Agent Trust HubPass](/gmgnai/gmgn-skills/gmgn-portfolio/security/agent-trust-hub)[SocketPass](/gmgnai/gmgn-skills/gmgn-portfolio/security/socket)[SnykPass](/gmgnai/gmgn-skills/gmgn-portfolio/security/snyk)Installed onopencode231codex230gemini-cli229kimi-cli229cursor229amp229

---
*Source: https://skills.yangsir.net/skill/daily-gmgn-portfolio*
*Markdown mirror: https://skills.yangsir.net/api/skill/daily-gmgn-portfolio/markdown*