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 |
references/implementation.md
View on GitHub# Implementation Details
## Transaction Type Classification
The monitor classifies whale transactions by flow direction:
- **DEPOSIT** (exchange inflow): Wallet sends to known exchange address. Signals potential selling pressure.
- **WITHDRAWAL** (exchange outflow): Known exchange sends to external wallet. Signals accumulation.
- **TRANSFER**: Wallet-to-wallet movement between non-exchange addresses. May indicate OTC deals, fund rebalancing, or cold storage rotation.
## Flow Analysis Interpretation
Exchange flow analysis aggregates deposits and withdrawals over a time window:
- **Net positive flow** to exchanges = more tokens entering exchanges than leaving = selling pressure
- **Net negative flow** from exchanges = more tokens leaving exchanges than entering = buying pressure
- **Neutral flow** = balanced activity, no clear directional signal
Typical flow thresholds for significance:
| Chain | Significant Net Flow | Major Net Flow |
|-------|---------------------|----------------|
| Ethereum | > $50M/day | > $200M/day |
| Bitcoin | > $100M/day | > $500M/day |
## Known Wallet Database
The monitor maintains a database of 100+ labeled addresses including:
- **Exchanges**: Binance, Coinbase, Kraken, FTX, Gemini hot/cold wallets
- **Funds**: Grayscale, Jump Trading, Three Arrows Capital
- **Bridges**: Wormhole, Multichain, Arbitrum Bridge
- **Protocols**: Lido, Aave, Compound treasury addresses
Search labels with:
```bash
python whale_monitor.py labels --query binance # Search by name
python whale_monitor.py labels --type exchange # List by type (exchange, fund, bridge, protocol)
```
## Watchlist Persistence
Watchlists are stored in `${CLAUDE_SKILL_DIR}/config/watchlist.json`:
```json
{
"wallets": [
{
"address": "0x28c6c...",
"name": "Binance Cold",
"added": "2024-01-15",
"chain": "ethereum"
}
]
}
```
## Multi-Chain Support
| Chain | Min Whale Threshold | Data Source |
|-------|-------------------|-------------|
| Ethereum | $1M | Whale Alert API + Etherscan |
| Bitcoin | $1M | Whale Alert API + Blockchain.com |
| Tron | $500K | Whale Alert API + Tronscan |
| Ripple | $500K | Whale Alert API |
## Output Formats
**Table format** (default): Human-readable with color indicators
**JSON format** (`--format json`): Machine-readable for pipeline integration
**Alert format** (`--format alert`): Compact one-line-per-transaction for monitoring
---
*[Tons of Skills](https://tonsofskills.com) by [Intent Solutions](https://intentsolutions.io) | [jeremylongshore.com](https://jeremylongshore.com)*
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 |