tracking-crypto-portfolio

Files (12)

• ARD.md
• PRD.md
• SKILL.md
• settings.yaml · config/
• errors.md · references/
• examples.md · references/
• implementation.md · references/
• formatters.py · scripts/
• portfolio_loader.py · scripts/
• portfolio_tracker.py · scripts/
• price_fetcher.py · scripts/
• valuation_engine.py · scripts/

SKILL.md (first lines)

# Tracking Crypto Portfolio

## Overview

This skill provides comprehensive cryptocurrency portfolio tracking with:

- **Real-Time Valuations**: Current prices from CoinGecko
- **Holdings Breakdown**: Quantity, value, and allocation per asset
- **P&L Tracking**: Unrealized gains/losses with cost basis
- **Allocation Analysis**: Category breakdown and concentration flags
- **Multiple Export Formats**: Table, JSON, CSV

**Key Capabilities:**
- Track holdings across multiple assets
- Calculate portfolio total value in USD
- Identify overweight positions (concentration risk)
- Export for analysis tools and tax reporting

## Prerequisites

Before using this skill, ensure:

1. **Python 3.8+** is installed
2. **requests** library is available: `pip install requests`
3. Internet connectivity for CoinGecko API access
4. A portfolio JSON file with your holdings

### Portfolio File Format

Create a portfolio file (e.g., `holdings.json`):

```json
{
  "name": "My Portfolio",
  "holdings": [
    {"coin": "BTC", "quantity": 0.5, "cost_basis": 25000},
    {"coin": "ETH", "quantity": 10, "cost_basis": 2000},
    {"coin": "SOL", "quantity": 100}
  ]
}
```

Fields:
- `coin`: Symbol (BTC, ETH, etc.) - **required**
- `quantity`: Amount held - **required**
- `cost_basis`: Average purchase price per coin (optional, for P&L)
- `acquired`: Date acquired (optional, for records)

## Instructions

### Step 1: Assess User Intent

Determine what portfolio information the user needs:
- **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

### Step 2: Execute Portfolio Tracking

Run the tracker with appropriate options:

```bash
# Quick portfolio summary
python {baseDir}/scripts/portfolio_tracker.py --portfolio holdings.json

# Full holdings breakdown
python {baseDir}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings

# Detailed analysis with P&L and allocations
python {baseDir}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed

# Export to JSON
python {baseDir}/scripts/portfolio_tracker.py --portfolio holdings.json --format json --output portfolio_export.json

# Export to CSV
python {baseDir}/scripts/portfolio_tracker.py --portfolio holdings.json --format csv --output portfolio.csv
```

### Step 3: Present Results

Format and explain the portfolio data:
- Show total portfolio value prominently
- Highlight 24h and 7d changes
- Explain allocation percentages
- Flag any concentration risks
- For detailed mode, explain P&L calculations

### Command-Line Options

| Option | Description | Default |
|--------|-------------|---------|
| `--portfolio` | Path to portfolio JSON file | Required |
| `--holdings` | Show all holdings breakdown | false |
| `--detailed` | Full analysis with P&L | false |
| `--sort` | Sort by: value, allocation, name, change | value |
| `--format` | Output format (table, json, csv) | table |
| `--output` | Output file path | stdout |
| `--threshold` | Allocation warning threshold | 25% |
| `--verbose` | Enable verbose output | false |

### Allocation Thresholds

By default, positions > 25% allocation are flagged:

| Allocation | Risk Level | Action |
|------------|------------|--------|
| < 10% | Low | Normal position |
| 10-25% | Medium | Monitor closely |
| 25-50% | High | Consider rebalancing |
| > 50% | Very High | Significant concentration risk |

## Output

### Table Format (Default)
```
==============================================================================
  CRYPTO PORTFOLIO TRACKER                          Updated: 2026-01-14 15:30
==============================================================================

From aAAaqwq/AGI-Super-Team, MIT.

More from aAAaqwq/AGI-Super-Team