jeremylongshore/tons-of-skills-marketplace / plugins/crypto/whale-alert-monitor/skills/monitoring-whale-activity
monitoring-whale-activity
VerifiedTrack large cryptocurrency transactions and whale wallet movements in real-time. Use when tracking large holder movements, exchange flows, or wallet activity. Trigger with phrases like "track whales", "monitor large transfers", "check whale activity", "exchange inflows", or "watch wallet".
| File | Kind | Size |
|---|---|---|
| ARD.md | markdown | 3.6 KB |
| PRD.md | markdown | 2.8 KB |
| SKILL.md | skill md | 3.8 KB |
| config/settings.yaml | config | 1.4 KB |
| references/errors.md | markdown | 2.8 KB |
| references/examples.md | markdown | 4.6 KB |
| references/implementation.md | markdown | 2.5 KB |
| scripts/formatters.py | script | 8.4 KB |
| scripts/price_service.py | script | 9.6 KB |
| scripts/wallet_labels.py | script | 11.6 KB |
| scripts/whale_api.py | script | 11.8 KB |
| scripts/whale_monitor.py | script | 12.0 KB |
PRD.md
View on GitHub# PRD: Whale Alert Monitor
## Summary
**One-liner**: Track large cryptocurrency transactions and whale wallet movements in real-time
**Domain**: Cryptocurrency / On-Chain Analytics / Market Intelligence
**Users**: Traders, Analysts, Researchers, Fund Managers
## Problem Statement
Large cryptocurrency holders ("whales") can significantly impact market prices when they move funds. Traders need visibility into these movements to:
- Anticipate potential market volatility
- Identify accumulation or distribution patterns
- Track known whale wallets for trading signals
- Monitor exchange inflows/outflows for price predictions
Currently, tracking whale activity requires manually monitoring multiple sources, subscribing to expensive services, or running complex blockchain queries.
## User Stories
1. **As a trader**, I want to see large transfers happening in real-time, so I can anticipate potential price movements.
- Acceptance: Shows transfers above threshold with USD value, source/destination labels
2. **As an analyst**, I want to track specific whale wallets over time, so I can identify accumulation/distribution patterns.
- Acceptance: Can add wallets to watchlist, shows historical activity summary
3. **As a researcher**, I want to analyze exchange inflows/outflows, so I can predict buying/selling pressure.
- Acceptance: Shows net flow by exchange with historical trends
4. **As a fund manager**, I want alerts when monitored wallets move funds, so I can react quickly.
- Acceptance: Configurable thresholds, clear alert formatting
## Functional Requirements
- **REQ-1**: Monitor real-time large transfers across major chains (ETH, BTC, SOL, etc.)
- **REQ-2**: Label known wallets (exchanges, funds, bridges, known whales)
- **REQ-3**: Calculate USD value of transfers at time of transaction
- **REQ-4**: Track wallet watchlists with historical activity
- **REQ-5**: Analyze exchange inflow/outflow patterns
- **REQ-6**: Support multiple output formats (table, JSON, alerts)
- **REQ-7**: Filter by chain, token, minimum value, wallet type
## API Integrations
| API | Purpose | Auth |
|-----|---------|------|
| Whale Alert API | Real-time whale transactions | API key (free tier available) |
| Etherscan | Ethereum transaction details | API key (free tier) |
| Blockchain.com | Bitcoin transaction data | No auth for basic |
| CoinGecko | USD price conversion | No auth for basic |
## Success Metrics
- Real-time alerts with < 60 second delay from on-chain confirmation
- Accurate wallet labeling for top 100 exchanges and known funds
- USD value accuracy within 1% of market price at transaction time
- Support for at least 5 major blockchains
## Non-Goals
- Automated trading based on whale alerts
- Wallet balance tracking (use blockchain-explorer for that)
- Historical whale pattern ML/AI predictions
- Social media whale alert aggregation
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |