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/examples.md

View on GitHub
# Usage Examples

## Recent Whale Transactions

### View All Recent Whales

```bash
python whale_monitor.py recent
```

### Filter by Blockchain

```bash
python whale_monitor.py recent --chain ethereum
python whale_monitor.py recent --chain bitcoin
python whale_monitor.py recent --chain solana
```

### Filter by Minimum Value

```bash
python whale_monitor.py recent --min-value 1000000    # $1M+
python whale_monitor.py recent --min-value 10000000   # $10M+
python whale_monitor.py recent --min-value 100000000  # $100M+
```

### Combine Filters

```bash
python whale_monitor.py recent --chain ethereum --min-value 5000000 --limit 50
```

### Show Full Addresses

```bash
python whale_monitor.py recent --addresses
```

## Exchange Flow Analysis

### Overall Exchange Flows

```bash
python whale_monitor.py flows
```

### Chain-Specific Flows

```bash
python whale_monitor.py flows --chain ethereum
python whale_monitor.py flows --chain bitcoin
```

### Large Flows Only

```bash
python whale_monitor.py flows --min-value 10000000
```

## Watchlist Management

### View Watchlist

```bash
python whale_monitor.py watchlist
```

### Add Wallet to Watchlist

```bash
python whale_monitor.py watch 0x1234... --name "Whale Wallet 1"
python whale_monitor.py watch 0xabcd... --name "Smart Money" --chain ethereum
python whale_monitor.py watch bc1q... --name "BTC Whale" --chain bitcoin --notes "Large holder since 2017"
```

### Remove from Watchlist

```bash
python whale_monitor.py unwatch 0x1234...
```

## Track Specific Wallets

### Track Known Wallet

```bash
python whale_monitor.py track 0x28c6c06298d514db089934071355e5743bf21d60
```

### Track with Chain Specified

```bash
python whale_monitor.py track bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h --chain bitcoin
```

## Wallet Labels

### Search Labels

```bash
python whale_monitor.py labels --query binance
python whale_monitor.py labels --query kraken
python whale_monitor.py labels --query aave
```

### List by Type

```bash
python whale_monitor.py labels --type exchange
python whale_monitor.py labels --type protocol
python whale_monitor.py labels --type fund
python whale_monitor.py labels --type bridge
```

## Output Formats

### JSON Output

```bash
python whale_monitor.py recent --format json
python whale_monitor.py flows --format json > flows.json
```

### Alert Style Output

```bash
python whale_monitor.py recent --format alert
```

## API Status

### Check API Status

```bash
python whale_monitor.py status
```

## Verbose Mode

### Enable Debug Output

```bash
python whale_monitor.py recent -v
python whale_monitor.py flows -v --chain ethereum
```

## Common Workflows

### Daily Whale Monitoring

```bash
# Morning check
python whale_monitor.py recent --min-value 5000000 --limit 30
python whale_monitor.py flows

# Watch for large movements
python whale_monitor.py recent --min-value 50000000
```

### Exchange Deposit/Withdrawal Analysis

```bash
# Check if whales are depositing (selling pressure)
python whale_monitor.py flows --chain ethereum

# Large deposits = potential selling
# Large withdrawals = potential accumulation
```

### Track Specific Protocol Treasury

```bash
# Add protocol wallet to watchlist
python whale_monitor.py watch 0xbe0eb53f46cd790cd13851d5eff43d12404d33e8 --name "Aave Treasury"

# Track its activity
python whale_monitor.py track 0xbe0eb53f46cd790cd13851d5eff43d12404d33e8
```

## Programmatic Usage

```python
from whale_api import WhaleAlertClient
from wallet_labels import WalletLabeler
from price_service import PriceService

# Initialize clients
client = WhaleAlertClient()
labeler = WalletLabeler()
prices = PriceService()

# Get recent whale transactions
txs = client.get_transactions(min_value=1000000, limit=10)

for tx in txs:
    # Enrich with labels
    from_label = labeler.label_wallet(tx.from_address)
    to_label = labeler.label_wallet(tx.to_address)

    print(f"{tx.amount} {tx.symbol} ({tx.amount_usd:,.0f} USD)")
    print(f"  From: {from_label.name}")
    print(f"  To: {to_label.name}")
    print()
```

## Integration Examples

### Pipe to jq for JSON Processing

```bash
python whale_monitor.py recent --format json | jq '.[] | select(.amount_usd > 10000000)'
```

### Export to CSV

```bash
python whale_monitor.py recent --format json | \
  jq -r '.[] | [.timestamp, .blockchain, .symbol, .amount, .amount_usd, .from_owner, .to_owner] | @csv'
```

### Filter and Count

```bash
python whale_monitor.py recent --format json --limit 100 | \
  jq '[.[] | select(.to_owner_type == "exchange")] | length'
```

---
*[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