Skip to content

jeremylongshore/tons-of-skills-marketplace / plugins/crypto/whale-alert-monitor/skills/monitoring-whale-activity

monitoring-whale-activity

Verified

Track 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".

FileKindSize
ARD.mdmarkdown3.6 KB
PRD.mdmarkdown2.8 KB
SKILL.mdskill md3.8 KB
config/settings.yamlconfig1.4 KB
references/errors.mdmarkdown2.8 KB
references/examples.mdmarkdown4.6 KB
references/implementation.mdmarkdown2.5 KB
scripts/formatters.pyscript8.4 KB
scripts/price_service.pyscript9.6 KB
scripts/wallet_labels.pyscript11.6 KB
scripts/whale_api.pyscript11.8 KB
scripts/whale_monitor.pyscript12.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)*
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall