Crypto Portfolio Tracker
Track your crypto portfolio across multiple chains with real-time prices, P&L calculation, and optional alerts. Zero API keys needed for basic functionality.
Quick Start
# Check a single wallet
bash scripts/check-wallet.sh 0xYourAddress ethereum
# Full portfolio scan (all configured wallets)
bash scripts/portfolio.sh
# Price check
bash scripts/price.sh BTC ETH SOL
Configuration
Create portfolio.json in your workspace:
{
"wallets": [
{ "address": "0x...", "chain": "ethereum", "label": "Main" },
{ "address": "0x...", "chain": "base", "label": "Trading" },
{ "address": "0x...", "chain": "arbitrum", "label": "DeFi" },
{ "address": "C122gx...", "chain": "solana", "label": "SOL Wallet" }
],
"manual": [
{ "token": "BTC", "amount": 0.5, "cost_basis": 30000 }
],
"alerts": [
{ "token": "BTC", "above": 70000, "message": "BTC broke $70K!" },
{ "token": "ETH", "below": 2000, "message": "ETH dropped below $2K" }
]
}
Features
Portfolio Overview
bash scripts/portfolio.sh
Output:
📊 Portfolio — 31 Mar 2026
Wallet: Main (ethereum)
0.5 ETH = $1,250.00
1000 USDC = $1,000.00
Wallet: Trading (base)
500 USDC = $500.00
Total: $2,750.00
24h Change: +$45.20 (+1.67%)
Price Tracking
bash scripts/price.sh BTC ETH SOL MATIC
Uses CoinGecko free API (no key, 30 calls/min).
Native Balance Check
# EVM chains (free public RPC)
bash scripts/check-wallet.sh 0xAddress ethereum|base|arbitrum|polygon|optimism
# Solana
bash scripts/check-wallet.sh SolAddress solana
P&L Calculation
bash scripts/pnl.sh
Compares current value vs cost basis (from portfolio.json manual entries or historical snapshots).
Price Alerts
bash scripts/alerts.sh
Checks configured alerts and outputs triggered ones. Run via cron for continuous monitoring.
Supported Chains
| Chain | RPC | Token Standard |
|---|---|---|
| Ethereum | etherscan free / public RPC | ERC-20 |
| Base | basescan / public RPC | ERC-20 |
| Arbitrum | arbiscan / public RPC | ERC-20 |
| Polygon | polygonscan / public RPC | ERC-20 |
| Optimism | optimistic.etherscan / public RPC | ERC-20 |
| Solana | solana mainnet-beta RPC | SPL |
Cron Integration
Add to OpenClaw cron for automated tracking:
Portfolio snapshot: bash ~/path/to/scripts/portfolio.sh --json >> ~/portfolio-history.jsonl
Price alerts: bash ~/path/to/scripts/alerts.sh
Data Sources
- Prices: CoinGecko free API (no key, rate limited to 30/min)
- EVM balances: Public RPCs or Etherscan free tier
- Solana balances: solana CLI or public RPC
- Token lists: CoinGecko token list
Limitations
- CoinGecko free tier: 30 calls/min, no historical data beyond 1 year
- Public RPCs may rate limit under heavy use
- ERC-20 token detection requires known token list (top 500 by market cap)
- For full token scanning, consider adding Moralis or Alchemy API keys