cryptowatch

Files (11)

• .gitignore
• README.md
• SKILL.md
• package.json
• blockchain.ts · src/
• cli.ts · src/
• config.ts · src/
• monitor.ts · src/
• prices.ts · src/
• telegram.ts · src/
• tsconfig.json

SKILL.md (first lines)

# CryptoWatch 📈

Your on-chain radar. Track wallets, set price alerts, monitor gas fees, and get notified the second something moves.

## When to Use

✅ **USE this skill when:**

- Tracking specific wallet addresses
- Setting price alerts for tokens
- Monitoring large whale transactions
- Watching gas fees for optimal transaction timing
- Getting notified of DeFi position changes
- Tracking NFT floor prices
- Monitoring mempool for pending transactions
- Portfolio tracking across multiple chains

## When NOT to Use

❌ **DON'T use this skill when:**

- Building automated trading bots → use dedicated bot frameworks
- Generating tax reports → use CoinTracker, Koinly, etc.
- Backtesting trading strategies → use TradingView, QuantConnect
- High-frequency trading → requires specialized infrastructure
- Complex DeFi analytics → use Dune Analytics, Nansen
- Full blockchain indexing → use The Graph, Alchemy

## Setup

Install CryptoWatch:

```bash
npm install -g @pawhub/cryptowatch
```

Connect to blockchain providers:

```bash
# Ethereum (Alchemy, Infura, or your own node)
cryptowatch add-provider ethereum \
  --rpc https://eth-mainnet.g.alchemy.com/v2/YOUR_API_KEY

# Polygon
cryptowatch add-provider polygon \
  --rpc https://polygon-mainnet.g.alchemy.com/v2/YOUR_API_KEY

# Base
cryptowatch add-provider base \
  --rpc https://mainnet.base.org

# Verify connection
cryptowatch status
```

Link Telegram for notifications:

```bash
cryptowatch setup telegram
```

## Example Interactions

### Price Alerts

**You:** Alert me if ETH drops below $3000

**Paw:** *sets up price watch*

✅ **Alert configured:**

**Asset:** ETH (Ethereum)
**Trigger:** Price drops below $3,000
**Current price:** $3,247
**Status:** Active, checking every 60 seconds

**Notification:** Telegram + system notification

You'll get pinged the moment it hits. Want to set an upper bound too? 📊

---

**You:** Yes, also alert me if it goes above $3500

**Paw:** *adds second alert*

✅ **Price bracket set:**

**ETH Alerts:**
- 🔻 Below $3,000
- 🔺 Above $3,500
- Current: $3,247 (within range)

I'll ping you if it breaks out of this zone. Classic buy-low-sell-high setup. 📈

---

**You:** What's the current gas fee?

**Paw:** *checks network*

**Ethereum Gas Prices:**

⚡ **Fast:** 45 gwei (~$8.50 for simple transfer)
⚙️ **Standard:** 32 gwei (~$6.00)
🐌 **Slow:** 25 gwei (~$4.75)

**Current congestion:** Moderate

**Recommendation:** Wait 2-3 hours if not urgent. Gas typically drops after 8 PM EST.

Want me to alert you when gas drops below 30 gwei? 🔔

---

**You:** Yes

**Paw:** ✅ Gas alert set. I'll ping you when fast gas drops below 30 gwei.

From Flexasaurusrex/OpenPaw, MIT.

More from Flexasaurusrex/OpenPaw