🚀 快速安装

复制以下命令并运行，立即安装此 Skill：

npx skills add https://skills.sh/gmgnai/gmgn-skills/gmgn-portfolio

💡 提示：需要 Node.js 和 NPM

使用 gmgn-cli 工具根据用户请求查询钱包投资组合数据。

子命令

子命令 描述
portfolio info 绑定到 API 密钥的钱包和主要货币余额
portfolio holdings 钱包代币持仓及盈亏
portfolio activity 交易历史记录
portfolio stats 交易统计（支持批量查询）
portfolio token-balance 特定代币的余额

支持的链

sol / bsc / base

先决条件

  • 包含 GMGN_API_KEY 的 .env 文件
  • 在包含 .env 文件的目录中运行，或在环境中设置 GMGN_HOST
  • 全局安装 gmgn-cli：npm install -g gmgn-cli@1.0.1

使用示例

# API 密钥关联的钱包信息（无需 --chain 或 --wallet）
gmgn-cli portfolio info

# 钱包持仓（默认排序）
gmgn-cli portfolio holdings --chain sol --wallet <钱包地址>

# 按美元价值降序排序的持仓
gmgn-cli portfolio holdings \
  --chain sol --wallet <钱包地址> \
  --order-by usd_value --direction desc --limit 20

# 包含已清仓的头寸
gmgn-cli portfolio holdings --chain sol --wallet <钱包地址> --sell-out

# 交易活动
gmgn-cli portfolio activity --chain sol --wallet <钱包地址>

# 按类型过滤的活动
gmgn-cli portfolio activity --chain sol --wallet <钱包地址> \
  --type buy --type sell

# 特定代币的活动
gmgn-cli portfolio activity --chain sol --wallet <钱包地址> \
  --token <代币地址>

# 交易统计（默认 7 天）
gmgn-cli portfolio stats --chain sol --wallet <钱包地址>

# 30 天交易统计
gmgn-cli portfolio stats --chain sol --wallet <钱包地址> --period 30d

# 多个钱包的批量统计
gmgn-cli portfolio stats --chain sol \
  --wallet <钱包地址1> --wallet <钱包地址2>

# 代币余额
gmgn-cli portfolio token-balance \
  --chain sol --wallet <钱包地址> --token <代币地址>

持仓选项

选项 描述
--limit <n> 每页数量（默认 20，最大 50）
--cursor <光标> 分页光标
--order-by <字段> 排序字段：usd_value（美元价值）/ last_active_timestamp（最后活跃时间）/ realized_profit（已实现盈亏）/ unrealized_profit（未实现盈亏）/ total_profit（总盈亏）/ history_bought_cost（历史买入成本）/ history_sold_income（历史卖出收入）（默认 usd_value）
--direction <asc|desc> 排序方向（默认 desc）
--sell-out 包含已清仓的头寸
--show-small 包含小价值头寸
--hide-abnormal 隐藏异常头寸
--hide-airdrop 隐藏空投头寸
--hide-closed 隐藏已关闭头寸
--hide-open 隐藏未平仓头寸

活动选项

选项 描述
--token <地址> 按代币过滤
--limit <n> 每页数量
--cursor <光标> 分页光标（传递上次响应中的 next 值）
--type <类型> 可重复：buy（买入）/ sell（卖出）/ add（增加）/ remove（移除）/ transfer（转账）

活动响应包含一个 next 字段。将其传递给 --cursor 以获取下一页。

统计选项

选项 描述
--period <周期> 统计周期：7d / 30d（默认 7d）

注意事项

  • 所有投资组合命令均使用标准认证（仅需 API 密钥，无需签名）
  • portfolio stats 支持多个 --wallet 标志进行批量查询
  • 使用 --raw 获取单行 JSON 以便进一步处理
  • 输入验证——钱包和代币地址会在运行时根据预期链格式进行验证（sol：base58 编码，32–44 个字符；bsc/base/eth：0x + 40 个十六进制数字）。如果输入无效，CLI 会退出并报错。

📄 原始文档

完整文档（英文）：

https://skills.sh/gmgnai/gmgn-skills/gmgn-portfolio

💡 提示：点击上方链接查看 skills.sh 原始英文文档，方便对照翻译。

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。