Skip to content

■ SKILLS // SKILL SPECS

crypto-portfolio-tracker

Professional crypto portfolio tracking with real-time prices, PnL analysis, and risk metrics

■ [!] ON THIS PAGE ▼
■ INSTALL // npx @self.md/cli install crypto-portfolio-tracker
AuthorJeremy Longshore
Namespace@jeremylongshore/claude-code-plugins-plus
Category#general
Version1.0.0
Stars★ 1,193
Downloads↓ 3
Verification[ ✓ ] self.md verified

Professional crypto portfolio tracking with real-time prices, PnL analysis, and risk metrics

Installation

npx claude-plugins install @jeremylongshore/claude-code-plugins-plus/crypto-portfolio-tracker

Contents

Folders: commands, skills

Files: LICENSE, README.md

Documentation

Professional-grade cryptocurrency portfolio tracking and analysis for Claude Code, providing institutional-quality metrics, risk assessment, and optimization recommendations.

Features

Position Tracking

  • Real-time price updates from multiple exchanges (CoinGecko, Binance, Coinbase)
  • Comprehensive PnL calculations with entry/exit tracking
  • Multi-exchange support for accurate pricing
  • Stop-loss and take-profit monitoring
  • Position history with complete audit trail
  • Alert system for significant price movements

Portfolio Analysis

  • Risk metrics: Sharpe ratio, Sortino ratio, maximum drawdown
  • Volatility analysis: Daily, weekly, monthly, and annual
  • Correlation matrix: Identify over-concentrated positions
  • Value at Risk (VaR): 95% and 99% confidence levels
  • Herfindahl Index: Measure portfolio concentration
  • Performance attribution: Understand what’s driving returns

Rebalancing Engine

  • Optimal allocation calculations using Modern Portfolio Theory
  • Automated rebalancing recommendations
  • Tax-aware trading suggestions
  • Cost estimation for rebalancing actions
  • Threshold-based or time-based rebalancing

Advanced Analytics

  • Risk-adjusted returns optimization
  • Diversification scoring
  • Market regime detection
  • Drawdown analysis
  • Monte Carlo simulations for future scenarios

Installation

/plugin install crypto-portfolio-tracker@claude-code-plugins-plus

FREE Data Sources: No Premium APIs Required

All portfolio tracking uses 100% free data sources - no CryptoCompare Pro or Messari subscriptions needed.

Quick Comparison

Data SourcePaid AlternativesFREE (This Plugin)
Price DataCryptoCompare Pro ($79/mo)CoinGecko: $0
Exchange DataMessari Pro ($99/mo)Binance/Coinbase API: $0
Historical DataKaiko ($500/mo)CoinGecko/Binance: $0
Portfolio AnalyticsTradingView Pro ($60/mo)Built-in: $0

Annual Savings: $948-7,188 for professional portfolio tracking.

Free APIs Used by This Plugin

1. CoinGecko (Primary - FREE)

What: 10,000+ cryptocurrencies with real-time pricing

Free Tier:

  • 10-50 calls/minute (generous)
  • No API key required
  • Full price history
  • Market cap, volume, 24h changes

Setup:

{
  "priceFeeds": {
    "primary": "coingecko"  // Already configured - FREE
  }
}

Cost: $0 (no signup required)

API: coingecko.com/api

2. Binance API (Fallback - FREE)

What: Real-time exchange data from world’s largest crypto exchange

Free Tier:

  • 1,200 requests/minute
  • No API key required for public data
  • Real-time orderbook data
  • 24h ticker statistics

Setup:

{
  "priceFeeds": {
    "fallback": ["binance"]  // Already configured - FREE
  }
}

Cost: $0

API: binance-docs.github.io/apidocs

3. Coinbase API (Fallback - FREE)

What: Institutional-grade pricing from regulated US exchange

Free Tier:

  • 10,000 requests/hour
  • No authentication for public endpoints
  • OHLCV candles
  • Real-time ticker

Setup:

{
  "priceFeeds": {
    "fallback": ["coinbase"]  // Already configured - FREE
  }
}

Cost: $0

API: docs.cloud.coinbase.com

Cost Comparison: Portfolio Tracking

Annual Subscriptions:

  • CryptoCompare Pro: $79/mo → $948/year (historical data)
  • Messari Pro: $99/mo → $1,188/year (fundamentals)
  • Kaiko: $500/mo → $6,000/year (institutional data)
  • TradingView Pro: $60/mo → $720/year (charts/analytics)
  • Total: $8,856/year

Free Approach (This Plugin)

Annual Subscriptions:

  • CoinGecko: $0
  • Binance API: $0
  • Coinbase API: $0
  • Built-in analytics: $0
  • Total: $0/year

Savings: $8,856/year with identical portfolio tracking quality.

Real Use Case Example

Portfolio Value Calculation

Paid Approach (CryptoCompare Pro):

// $948/year subscription
const response = await fetch(
  `https://min-api.cryptocompare.com/data/price?fsym=BTC&tsyms=USD&api_key=${CRYPTOCOMPARE_KEY}`
);

Free Approach (CoinGecko - This Plugin):

// $0/year - already configured
const response = await fetch(
  'https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd'
);

Cost: $0 (vs $948/year) Data Quality: Identical (aggregated from same exchanges)

Data Quality Comparison

MetricPaid (CryptoCompare)FREE (CoinGecko)
Cryptocurrencies6,000+10,000+ ✅
Update FrequencyReal-timeReal-time ✅
Historical DataFull historyFull history ✅
Exchange Coverage200+ exchanges600+ exchanges ✅
Cost$948/yea

Included Skills

This plugin includes 1 skill definition:

tracking-crypto-portfolio

|

View skill definition

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):

{
  "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: To

Source

View on GitHub