ClawWatch

Track, manage, and get price alerts for crypto and stocks, view market overviews, and check the Crypto Fear & Greed Index.

ClawWatch — Watchlist Skill

Quick Reference

User says...	You run...
"Füg Bitcoin zur Watchlist hinzu"	clawwatch add BTC
"Add NVIDIA and Tesla"	clawwatch add NVDA TSLA --tag portfolio
"Wie steht meine Watchlist?"	clawwatch check --json → parse & summarize
"Zeig mir nur die Kryptos"	clawwatch list --type crypto --json
"Alert wenn BTC über 100k geht"	clawwatch alert add BTC above 100000
"Alert if ETH drops 5% in a day"	clawwatch alert add ETH change 5
"Wie ist die Marktstimmung?"	clawwatch feargreed
"Entferne TSLA"	clawwatch remove TSLA
"Check my alerts"	clawwatch alert check --json
"Export als CSV"	clawwatch export --format csv

How to Use

1. Run commands via Bash tool: bash clawwatch <command>
2. Use --json flag to get machine-readable output you can parse
3. Summarize results in natural language for the user
4. For deep analysis, pass the JSON data to market-analyst agent

Important Rules

• Always use --json flag when you need to parse the output programmatically
• Don't run clawwatch check too frequently — respect API rate limits (max every 60 seconds)
• Auto-detection: Just pass symbols like BTC, ETH, NVDA, SAP.DE — the tool auto-detects crypto vs stock
• Alert exit codes: clawwatch alert check returns exit code 0 (no alerts) or 1 (triggered)

Combining with market-analyst

When the user asks for analysis (not just prices), chain:

1. clawwatch check --json → get current prices
2. Pass relevant data to market-analyst for interpretation
3. Deliver combined response

Reading Cached Data

Instead of running CLI commands, you can read cached data directly:

• ~/.clawwatch/latest.json — Last fetched prices
• ~/.clawwatch/watchlist.json — Full watchlist state

Installation

pip install clawwatch
# No API keys needed for crypto! Works out of the box.
# Optional: set CoinCap key for higher rate limits
clawwatch config --coincap-key YOUR_KEY  # optional