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#

bash

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

json

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

bash scripts/portfolio.sh

Output:

text

📊 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

bash scripts/price.sh BTC ETH SOL MATIC

Uses CoinGecko free API (no key, 30 calls/min).

Native Balance Check#

bash

# 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

bash scripts/pnl.sh

Compares current value vs cost basis (from portfolio.json manual entries or historical snapshots).

Price Alerts#

bash

bash scripts/alerts.sh

Checks configured alerts and outputs triggered ones. Run via cron for continuous monitoring.

Supported Chains#

ChainRPCToken StandardEthereumetherscan free / public RPCERC-20Basebasescan / public RPCERC-20Arbitrumarbiscan / public RPCERC-20Polygonpolygonscan / public RPCERC-20Optimismoptimistic.etherscan / public RPCERC-20Solanasolana mainnet-beta RPCSPL

Cron Integration#

Add to OpenClaw cron for automated tracking:

text

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