SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场tracking-crypto-portfolio

tracking-crypto-portfolio

数据与分析

查看项目

更新于 10-16 09:10

技能介绍

用途

该技能用于追踪加密货币投资组合，基于 CoinGecko 实时估值，提供持仓明细、配置分析、盈亏（P&L）跟踪以及集中度风险提示。适用场景包括：检查投资组合价值、查看持仓拆分、进行详细分析以及导出数据。

主要能力

  • 实时估值：通过 CoinGecko API 获取加密货币价格，计算组合总值。
  • 持仓明细：列出全部持仓的币种、数量、价格、价值与占比。
  • 配置分析：展示各资产在组合中的配置百分比。
  • 盈亏跟踪：显示 24 小时与 7 天的价值变化及百分比。
  • 集中度风险提示：默认对占比超过 25% 的持仓发出警告，阈值可自定义。
  • 导出：支持 JSON 与 CSV 格式，便于外部分析工具或税务申报使用。

前提条件

  • 已安装 Python 3.8+。
  • 安装依赖：pip install requests。
  • 需要联网以访问 CoinGecko API。
  • 准备一个包含持仓的 portfolio JSON 文件（格式参见 references/implementation.md）。

使用方式

在技能目录下通过命令行运行脚本，常见用法如下：

快速组合摘要： python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json

完整持仓拆分： python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings

含盈亏与配置的详细分析： python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed

导出 JSON 或 CSV： python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format json --output portfolio_export.json python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format csv --output portfolio.csv

其他示例：

按配置排序显示全部持仓： python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings --sort allocation

自定义 15% 集中度阈值进行详细分析： python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed --threshold 15

导出供税务软件使用的 CSV： python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format csv --output tax_export.csv

使用绝对路径： python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio ~/crypto/holdings.json

结果呈现

运行时先判断用户意图（快速检查、持仓列表、详细分析、导出），再选择相应选项。向用户展示结果时，突出组合总值，突出 24 小时与 7 天变化，解释配置百分比，并标记集中度风险（默认占比超过 25% 的持仓）。

输出示例包含组合摘要、总值、24h/7d 变化、持仓数量、按占比排列的主要持仓及其价格与占比、以及超过阈值的警告，例如：

  • Total Value: $125,450.00 USD
  • 24h Change: +$2,540.50 (+2.07%)
  • 7d Change: +$8,125.00 (+6.92%)
  • Holdings: 8 assets
  • WARNING: BTC (37.9%) exceeds 25% threshold

错误处理

  • 找不到投资组合文件：路径无效，请检查文件路径是否存在。
  • JSON 无效：文件格式错误，请校验 JSON 语法。
  • 找不到币种：符号未知，请检查符号拼写并使用标准符号。
  • API 触发限流：请求过多，请稍后重试或使用缓存。

更多错误处理说明参见 ${CLAUDE_SKILL_DIR}/references/errors.md。

资源与配置

  • ${CLAUDE_SKILL_DIR}/references/implementation.md：投资组合文件格式、CLI 选项、配置阈值、JSON 格式。
  • ${CLAUDE_SKILL_DIR}/references/errors.md：全面的错误处理。
  • ${CLAUDE_SKILL_DIR}/references/examples.md：详细使用示例。
  • CoinGecko API：https://www.coingecko.com/en/api
  • ${CLAUDE_SKILL_DIR}/config/settings.yaml：配置选项。

限制

使用依赖联网访问 CoinGecko API，可能受该 API 的速率限制、可用性与数据准确性影响；投资组合文件需自行按指定格式准备；具体支持币种与阈值配置以脚本与配置文档为准。