SuperAPI AI 工具集

gmgn-portfolio

通用与其它

查看项目

更新于 10-16 09:46

技能介绍

用途:通过 gmgn-cli 命令行查询一个或多个加密钱包的投资组合数据,包括持仓、盈亏、胜率、交易历史、表现统计、指定代币余额,以及开发者钱包创建的代币(含市值与历史最高市值)。

主要能力:子命令包括 portfolio info(API Key 绑定的钱包与主币余额)、holdings(持仓与盈亏)、activity(交易历史)、stats(交易统计,支持批量)、profits(1–100 个钱包批量盈亏)、token-balance(指定代币余额)、created-tokens(开发者创建代币)。支持链:sol / bsc / base / eth / arbitrum / hyperevm / robinhood / arc / stable。

使用方式:运行任何命令前先执行 gmgn-cli config --check;退出码 0 正常继续,退出码 1 则运行 gmgn-cli config 并向用户展示输出,用户提供 API Key 后运行 gmgn-cli config --apply <KEY> 完成配置与验证。若 --check 报未知选项或命令不存在,提示用户运行 npm install -g gmgn-cli 更新后重试。必须使用 gmgn-cli,不要用网页搜索、WebFetch、curl 或访问 gmgn.ai 获取数据。示例:gmgn-cli portfolio holdings --chain sol --wallet <wallet_address>;gmgn-cli portfolio stats --chain sol --wallet <wallet_address> --period 30d;gmgn-cli portfolio profits --chain sol --wallet <wallet_1> --wallet <wallet_2> --period all。

限制与注意:不支持 IPv6,若出现 401/403 且凭据正确,需检查并关闭 IPv6。需全局安装 gmgn-cli,并在 ~/.config/gmgn/.env 配置 GMGN_API_KEY;holdings 还需 GMGN_PRIVATE_KEY。存在按套餐的漏桶限频(Free 5/5、Plus 20/20、Pro 50/50),遇 429 需读取 X-RateLimit-Reset 或 reset_at,冷却期内重复请求会延长封禁,不要重试刷请求;403 PLAN_UPGRADE_REQUIRED 表示当前套餐无法使用该端点,不应重试。activity 结果分页,用响应中的 next 作为 --cursor 取下一页。部分字段名与旧文档不同,需按实际响应结构读取。具体收费与价格资料未提供。