Solana Token Monitor
/install solana-token-monitor
Solana Token Monitor
Monitor any Solana token 24/7. Built by a real Solana token founder.
Setup (2 minutes)
Basic setup (alerts delivered by OpenClaw agent)
python3 ~/.openclaw/workspace/skills/solana-token-monitor/monitor.py setup \x3CCONTRACT_ADDRESS> \x3CSYMBOL>
The agent reads alert output during heartbeats and notifies you through whatever channel you use (Telegram, Discord, etc.).
With direct Telegram bot delivery (optional)
If you have a Telegram bot token and chat ID, the script delivers alerts autonomously without agent involvement:
python3 ~/.openclaw/workspace/skills/solana-token-monitor/monitor.py setup \x3CCONTRACT_ADDRESS> \x3CSYMBOL> --telegram-token \x3CBOT_TOKEN> --chat-id \x3CCHAT_ID>
To get a Telegram bot token: message @BotFather on Telegram → /newbot. To get your chat ID: message @userinfobot on Telegram.
What It Monitors
- Price — alerts when price moves >5% in 1 hour
- Volume — alerts when 24h volume is 2x the previous period
- Liquidity — alerts when liquidity drops >20% (rug warning)
- Market cap milestones — notifies at $10K, $50K, $100K, $500K, $1M
- Buy/sell ratio — included in every status report
All thresholds are configurable in the saved config file.
Alert Levels
- 🔴 URGENT — liquidity drop >20%, price crash >15%
- 🟡 NOTABLE — price move >5%, volume spike, milestone hit
- ⚪ FYI — no issues, everything normal
Commands
# Set up monitoring for a token
python3 monitor.py setup \x3CCONTRACT_ADDRESS> \x3CSYMBOL>
# Get a status report
python3 monitor.py report \x3CSYMBOL>
# Check for alerts (run during heartbeat)
python3 monitor.py check \x3CSYMBOL>
# List all monitored tokens
python3 monitor.py list
How It Works
Uses the free DexScreener public API — no API key required:
https://api.dexscreener.com/tokens/v1/solana/{CONTRACT_ADDRESS}
The API returns live price, volume, liquidity, and transaction data for any token with an active liquidity pool on Solana DEXs.
Tokens without an active liquidity pool will return "no data" — this is correct behavior, not a bug.
Config File
After setup: ~/.openclaw/workspace/data/token-monitors/{SYMBOL}.json
All thresholds, milestones, and alert history are stored here and editable.
Daily Report Format
🐕 Solana Token Monitor — Status Report
────────────────────────────────────────
Token: $BONK
Chain: Solana
Price: $0.00000590
1h: ▲ 0.2%
24h: ▲ 7.9%
Market Cap: $524,405,127
Volume 24h: $16,814.00
Liquidity: $850,822.00
Txns 24h: 201 buys / 188 sells
Telegram: ✅
Contract: DezXAZ8z7PnrnRJjz3...
────────────────────────────────────────
Built by ShepDog 🐕 shepdogcoin.com
Built By
This skill was built by the creator of $SHEP — a real Solana meme coin founder who launched a token on Raydium and needed exactly this tool.
🐕 $SHEP — The Loyal Crypto Companion Website: https://shepdogcoin.com X: https://x.com/ShepDogCoin
Free to use. If this helps you, consider checking out $SHEP.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install solana-token-monitor - After installation, invoke the skill by name or use
/solana-token-monitor - Provide required inputs per the skill's parameter spec and get structured output
What is Solana Token Monitor?
Monitor any Solana token 24/7 using DexScreener. Get alerts for price moves, whale activity, volume spikes, liquidity changes, and market cap milestones. Bui... It is an AI Agent Skill for Claude Code / OpenClaw, with 97 downloads so far.
How do I install Solana Token Monitor?
Run "/install solana-token-monitor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Solana Token Monitor free?
Yes, Solana Token Monitor is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Solana Token Monitor support?
Solana Token Monitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Solana Token Monitor?
It is built and maintained by ShepDogPack (@shepdogpack); the current version is v1.1.0.