calculating-crypto-taxes

---

name: calculating-crypto-taxes version: 1.0.0 description: | Calculate cryptocurrency tax obligations with cost basis tracking and jurisdiction rules. Use when calculating crypto tax obligations. Trigger with phrases like "calculate crypto taxes", "compute tax liability", or "generate tax report". allowed-tools: Read, Write, Edit, Grep, Glob, Bash(crypto:tax-*) license: MIT

Prerequisites

Before using this skill, ensure you have:

• Access to crypto market data APIs (CoinGecko, CoinMarketCap, or similar)
• Blockchain RPC endpoints or node access (Infura, Alchemy, or self-hosted)
• API keys for exchanges if trading or querying account data
• Web3 libraries installed (ethers.js, web3.py, or equivalent)
• Understanding of blockchain concepts and crypto market dynamics

Instructions

Step 1: Configure Data Sources

Set up connections to crypto data providers:

1. Use Read tool to load API credentials from {baseDir}/config/crypto-apis.env
2. Configure blockchain RPC endpoints for target networks
3. Set up exchange API connections if required
4. Verify rate limits and subscription tiers
5. Test connectivity and authentication

Step 2: Query Crypto Data

Retrieve relevant blockchain and market data:

1. Use Bash(crypto:tax-*) to execute crypto data queries
2. Fetch real-time prices, volumes, and market cap data
3. Query blockchain for on-chain metrics and transactions
4. Retrieve exchange order book and trade history
5. Aggregate data from multiple sources for accuracy

Step 3: Analyze and Process

Process crypto data to generate insights:

• Calculate key metrics (returns, volatility, correlation)
• Identify patterns and anomalies in data
• Apply technical indicators or on-chain signals
• Compare across timeframes and assets
• Generate actionable insights and alerts

Step 4: Generate Reports

Document findings in {baseDir}/crypto-reports/:

• Market summary with key price movements
• Detailed analysis with charts and metrics
• Trading signals or opportunity recommendations
• Risk assessment and position sizing guidance
• Historical context and trend analysis

Output

The skill generates comprehensive crypto analysis:

Market Data

Real-time and historical metrics:

• Current prices across exchanges with spread analysis
• 24h volume, market cap, and circulating supply
• Price changes across multiple timeframes (1h, 24h, 7d, 30d)
• Trading volume distribution by exchange
• Liquidity metrics and slippage estimates

On-Chain Metrics

Blockchain-specific analysis:

• Transaction count and network activity
• Active addresses and user growth metrics
• Token holder distribution and concentration
• Smart contract interactions and DeFi TVL
• Gas usage and network congestion indicators

Technical Analysis

Trading indicators and signals:

• Moving averages (SMA, EMA) and trend identification
• RSI, MACD, Bollinger Bands technical indicators
• Support and resistance levels
• Chart patterns and breakout signals
• Volume profile and accumulation zones

Risk Metrics

Portfolio and position risk assessment:

• Value at Risk (VaR) calculations
• Portfolio correlation and diversification metrics
• Volatility analysis and beta to market
• Drawdown statistics and recovery times
• Liquidation risk for leveraged positions

Error Handling

Common issues and solutions:

API Rate Limit Exceeded

• Error: Too many requests to crypto data API
• Solution: Implement request throttling; use caching for frequently accessed data; upgrade API tier if needed

Blockchain RPC Errors

• Error: Cannot connect to blockchain node or timeout
• Solution: Switch to backup RPC endpoint; verify network connectivity; check if node is synced

Invalid Address or Transaction

• Error: Blockchain address format invalid or transaction not found
• Solution: Validate address checksums; verify network (mainnet vs testnet); allow time for transaction confirmation

Exchange API Authentication Failed

• Error: Invalid API key or signature mismatch
• Solution: Regenerate API keys; verify permissions (read/trade); check system clock synchronization for signatures

Resources

Crypto Data Providers

• CoinGecko API for market data across thousands of assets
• Etherscan API for Ethereum blockchain data
• Dune Analytics for on-chain SQL queries
• The Graph for decentralized blockchain indexing

Web3 Libraries

• ethers.js for Ethereum smart contract interaction
• web3.py for Python-based blockchain queries
• viem for TypeScript Web3 development
• Hardhat for local blockchain testing

Trading and Analysis Tools

• TradingView for technical analysis and charting
• Glassnode for advanced on-chain metrics
• DeFi Llama for DeFi protocol analytics
• Nansen for wallet tracking and smart money flows

Best Practices

• Never store private keys or seed phrases in code
• Always verify smart contract addresses from official sources
• Use testnet for experimentation before mainnet
• Implement proper error handling for network failures
• Monitor gas prices before submitting transactions
• Validate all user inputs to prevent injection attacks