技能 效率工具 加密货币投资组合追踪

加密货币投资组合追踪

v20260423
tracking-crypto-portfolio
该工具提供全面的加密货币持仓追踪和分析功能。它利用外部API获取实时估值,分析资产配置,并跟踪盈亏(P&L)和集中度风险。适用于需要检查总投资价值、查看详细持仓、分析投资组合多元化程度,或将数据导出用于税务报告和记录存档的用户。
获取技能
397 次下载
概览

Tracking Crypto Portfolio

Overview

Track cryptocurrency holdings with real-time CoinGecko valuations, allocation analysis, P&L tracking, and concentration risk alerts.

Prerequisites

  1. Python 3.8+ installed
  2. Dependencies: pip install requests
  3. Internet connectivity for CoinGecko API access
  4. A portfolio JSON file with your holdings (see references/implementation.md for format)

Instructions

  1. Assess user intent - determine what portfolio view is needed:
  • Quick check: total value and top holdings
  • Holdings list: full breakdown of all positions
  • Detailed analysis: allocations, P&L, risk flags
  • Export: JSON or CSV for external tools
  1. Run the portfolio tracker with appropriate options:

```bash

Quick portfolio summary

python ${CLAUDESKILLDIR}/scripts/portfolio_tracker.py --portfolio holdings.json

Full holdings breakdown

python ${CLAUDESKILLDIR}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings

Detailed analysis with P&L and allocations

python ${CLAUDESKILLDIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed
```

  1. Export results for analysis tools or tax reporting:

```bash
python ${CLAUDESKILLDIR}/scripts/portfoliotracker.py --portfolio holdings.json --format json --output portfolioexport.json
python ${CLAUDESKILLDIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format csv --output portfolio.csv
```

  1. Present results to the user:
  • Show total portfolio value prominently
  • Highlight 24h and 7d changes
  • Explain allocation percentages
  • Flag any concentration risks (positions > 25% allocation by default)

Output

Summary showing total value, 24h/7d changes, per-asset allocation, and concentration warnings for positions exceeding threshold:

==============================================================================
  CRYPTO PORTFOLIO TRACKER                          Updated: 2026-01-14 15:30  # 2026 - current year timestamp
==============================================================================

  PORTFOLIO SUMMARY: My Portfolio
------------------------------------------------------------------------------
  Total Value:    $125,450.00 USD
  24h Change:     +$2,540.50 (+2.07%)
  7d Change:      +$8,125.00 (+6.92%)
  Holdings:       8 assets

  TOP HOLDINGS
------------------------------------------------------------------------------
  Coin     Quantity      Price         Value      Alloc   24h
  BTC      0.500     $95,000.00   $47,500.00    37.9%   +2.5%
  ETH      10.000     $3,200.00   $32,000.00    25.5%   +1.8%
  SOL      100.000      $180.00   $18,000.00    14.4%   +4.2%

  WARNING: BTC (37.9%) exceeds 25% threshold

==============================================================================

Error Handling

ErrorCauseSolution
Portfolio file not foundInvalid pathCheck file path exists
Invalid JSONMalformed fileValidate JSON syntax
Coin not foundUnknown symbolCheck symbol spelling, use standard symbols
API rate limitedToo many requestsWait and retry, use caching

See ${CLAUDE_SKILL_DIR}/references/errors.md for comprehensive error handling.

Examples

Portfolio tracking workflows from quick checks to detailed analysis and export:

# Basic portfolio check
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio ~/crypto/holdings.json

# All holdings sorted by allocation
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings --sort allocation

# Detailed analysis with custom 15% threshold
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed --threshold 15

# Export for tax software
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format csv --output tax_export.csv

Resources

  • ${CLAUDE_SKILL_DIR}/references/implementation.md - Portfolio file format, CLI options, allocation thresholds, JSON format
  • ${CLAUDE_SKILL_DIR}/references/errors.md - Comprehensive error handling
  • ${CLAUDE_SKILL_DIR}/references/examples.md - Detailed usage examples
  • CoinGecko API: https://www.coingecko.com/en/api
  • ${CLAUDE_SKILL_DIR}/config/settings.yaml - Configuration options
信息
分类 效率工具
名称 tracking-crypto-portfolio
版本 v20260423
大小 30.02KB
更新时间 2026-09-06
语言