Agent Launch Monitor
Track post-launch metrics for tokens deployed via Agent Launchpad (or any Base token).
What It Does
- Price tracking — Current price, 1h/24h changes, ATH detection
- Volume monitoring — 24h volume, spike detection
- Holder counts — Via Etherscan V2 API, milestone alerts
- Liquidity tracking — Pool liquidity, low liquidity warnings
- ROI from launch — Track performance vs launch price
- Historical state — Persisted across runs for trend analysis
Quick Start
# One-time check
./scripts/monitor.mjs check 0xf3ce5d9e5c2fba3d9f9fbac093b7c6c4e38bb07
# Add token to tracking
./scripts/monitor.mjs track 0xf3ce... "AXIOM"
# Check all tracked tokens
./scripts/monitor.mjs status
# Check for alerts (use in cron)
./scripts/monitor.mjs alerts
Commands
| Command | Description |
|---|---|
check <address> | One-time token metrics check |
track <address> [name] | Add token to persistent monitoring |
untrack <address> | Remove token from monitoring |
status | Display all tracked tokens with metrics |
alerts | Check for alert conditions (price changes, milestones) |
json | Output current status as JSON |
Alert Types
| Alert | Trigger | Severity |
|---|---|---|
PRICE_PUMP | Price up ≥20% since last check | medium/high |
PRICE_DUMP | Price down ≥20% since last check | medium/high |
NEW_ATH | New all-time high reached | high |
VOLUME_SPIKE | Volume 3x previous period | medium |
HOLDER_MILESTONE | Reached 100/500/1K/5K/10K holders | medium |
LOW_LIQUIDITY | Liquidity dropped below $1,000 | high |
Configuration
Create config.json to customize thresholds:
{
"priceChangeAlertPct": 20,
"volumeSpikeMultiple": 3,
"holderMilestones": [100, 500, 1000, 5000, 10000],
"liquidityMinUsd": 1000,
"checkIntervalMs": 300000
}
Cron Integration
Add to OpenClaw cron for automated monitoring:
# Check every 5 minutes
*/5 * * * * cd /path/to/skill && ./scripts/monitor.mjs alerts
Or via OpenClaw cron job:
{
"name": "token-monitor",
"schedule": { "kind": "every", "everyMs": 300000 },
"payload": { "kind": "systemEvent", "text": "Run token monitor alerts" },
"sessionTarget": "main"
}
Telegram Alerts
Pipe alerts to Telegram:
#!/bin/bash
OUTPUT=$(./scripts/monitor.mjs alerts)
if echo "$OUTPUT" | grep -q "🚨"; then
# Send via OpenClaw message tool
echo "$OUTPUT"
fi
Environment Variables
| Variable | Required | Description |
|---|---|---|
ETHERSCAN_API_KEY | Optional | Enables holder count tracking |
OUTPUT_JSON | Optional | Include JSON in alerts output |
Data Sources
- Dexscreener API — Price, volume, liquidity, pairs (no key, 300 req/min)
- Etherscan V2 API — Holder counts (requires key)
- Base RPC — Token info (name, symbol, supply)
State Files
state.json— Tracked tokens, history, ATH pricesconfig.json— Alert thresholds (optional)
Example Output
📊 AXIOM (AXIOM)
Address: 0xf3ce5d9e5c2fba3d9f9fbac093b7c6c4e38bb07
💰 Price: $0.00001234
1h: +5.23%
24h: -12.45%
📈 Market Cap: $123,456
FDV: $1,234,567
💧 Liquidity: $45,678
📊 Volume 24h: $12,345
👥 Holders: 234
🔗 DEX: uniswap | Pair: 0x1234abcd...
⏰ Checked: 2026-02-01T20:00:00.000Z
🚀 Launch: $0.00000500 | ROI: 146.8%
🏆 ATH: $0.00002000
Use Cases
- Track your own token — Monitor $AXIOM or tokens from Agent Launchpad
- Watch competitors — Track similar agent tokens
- LP management — Know when liquidity is low
- Community updates — Auto-post milestones to Twitter/Telegram