Skip to main content
skill CX Codex

tracking-crypto-portfolio — Claude Code skill: monitor crypto holdings

tracking-crypto-portfolio — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode that monitors crypto holdings with live valuations, asset allocation analysis, and P&L tracking.

MIT 1 installs ★ 2,935 updated 2026-11-01

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add jeremylongshore/tons-of-skills-marketplace --skill tracking-crypto-portfolio -a claude-code
Open on GitHub

What tracking-crypto-portfolio does

Fetches coin prices from CoinGecko API, calculates portfolio total in USD, computes allocation percentages, and tracks 24-hour and 7-day changes. Flags positions exceeding a concentration threshold (25% by default) to highlight concentration risk.

Requires Python 3.8+ and the requests library installed via pip install requests. Your holdings are defined in a JSON file with coin symbols, quantities, and purchase details. The skill outputs a table with top holdings, total portfolio value, and daily or weekly gain/loss.

Export results to JSON or CSV format for tax software and external portfolio analysis tools.

What it helps with

  • check total crypto portfolio value in USD with latest prices
  • view allocation percentages and top-performing holdings
  • calculate profit and loss over 24 hours or 7 days
  • identify positions exceeding safe concentration limits
  • export portfolio to JSON or CSV for tax reporting

Example prompts for the agent

  • Show my portfolio and flag any positions over 25%
  • Analyze the allocation breakdown in holdings.json with a 15% threshold
  • Export my portfolio to CSV for tax software

How to install tracking-crypto-portfolio

1Skills CLI (Vercel)

npx skills add jeremylongshore/tons-of-skills-marketplace --skill tracking-crypto-portfolio -a claude-code

2Manually: put the files in place

~/.claude/skills/tracking-crypto-portfolio/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/tracking-crypto-portfolio/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about tracking-crypto-portfolio

How do I install tracking-crypto-portfolio in Claude Code?

Run npx skills add jeremylongshore/tons-of-skills-marketplace --skill tracking-crypto-portfolio -a claude-code, then open the config at ~/.claude/skills/tracking-crypto-portfolio/SKILL.md.

What does tracking-crypto-portfolio do?

It fetches live coin prices from CoinGecko, calculates your total portfolio value in USD, shows allocation percentages for each asset, tracks 24-hour and 7-day changes, and alerts you to positions that exceed your concentration threshold.

What do I need to run this skill?

Python 3.8 or later, the requests library (install via pip install requests), internet access for CoinGecko API calls, and a JSON file describing your crypto holdings.

Source text

SKILL.md · MIT
---
name: tracking-crypto-portfolio
description: 'Track cryptocurrency portfolio with real-time valuations, allocation
  analysis, and P&L tracking.

  Use when checking portfolio value, viewing holdings breakdown, analyzing allocations,
  or exporting portfolio data.

  Trigger with phrases like "show my portfolio", "check crypto holdings", "portfolio
  allocation", "track my crypto", or "export portfolio".

  '
allowed-tools: Read, Write, Bash(crypto:portfolio-*)
version: 1.28.0
author: Jeremy Longshore <[email protected]>
license: MIT
tags:
- crypto
- tracking-crypto
compatibility: Designed for Claude Code
---
# 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

2. **Run the portfolio tracker** with appropriate options:

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

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

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

3. **Export results** for analysis tools or tax reporting:

   ```bash
   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
   ```

4. **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

| Error | Cause | Solution |
|-------|-------|----------|
| Portfolio file not found | Invalid path | Check file path exists |
| Invalid JSON | Malformed file | Validate JSON syntax |
| Coin not found | Unknown symbol | Check symbol spelling, use standard symbols |
| API rate limited | Too many requests | Wait and retry, use caching |

See [`references/errors.md`](references/errors.md) for comprehensive error handling.

## Examples

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

```bash
# 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

- [`references/implementation.md`](references/implementation.md) - Portfolio file format, CLI options, allocation thresholds, JSON format
- [`references/errors.md`](references/errors.md) - Comprehensive error handling
- [`references/examples.md`](references/examples.md) - Detailed usage examples
- CoinGecko API: https://www.coingecko.com/en/api
- `${CLAUDE_SKILL_DIR}/config/settings.yaml` - Configuration options

© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace

Similar skills

All skills for Finance and business →

From the same set139

The whole set →
lokalise-cost-tuning lokalise-cost-tuning audits Lokalise usage, contributor seats, translation workflows, and unused keys when you need to review or reduce localization costs. CX Codex +1 1installs optimizing-defi-yields optimizing-defi-yields — a skill for finding and comparing yields across DeFi protocols with APY/APR calculations, risk assessment, and optimization guidance. CX Codex +1 1installs optimizing-staking-rewards optimizing-staking-rewards compares staking yields across PoS networks and liquid protocols with risk evaluations. Helps identify competitive rates and rebalance positions. CX Codex +1 1installs tracking-crypto-derivatives tracking-crypto-derivatives collects public exchange data on crypto derivatives, including funding, open interest, futures basis, liquidations and options. Use it to compare markets by symbol. CX Codex +1 1installs calculating-crypto-taxes calculating-crypto-taxes is a Claude Code skill that processes exchange CSVs, calculates crypto capital gains using FIFO, LIFO, or HIFO, and prepares Form 8949 data. CX Codex +1 1installs finding-arbitrage-opportunities finding-arbitrage-opportunities compares top bid and ask prices for a crypto pair across exchanges, applies taker fees, and searches triangular cycles. Useful for checking price gaps. CX Codex +1 1installs routing-dex-trades routing-dex-trades — a skill that pulls quotes from 1inch, Paraswap, and 0x to find swap routes with lower slippage and gas. Use it before trading to compare venues or split a large order. CX Codex +1 1installs simulating-flash-loans simulating-flash-loans simulates flash loans across Aave V3, dYdX, and Balancer without spending real tokens. It estimates arbitrage and liquidation net profits, gas costs, and execution risks. CX Codex +1 1installs

Project sponsors

Companies that keep this analytics open