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

Security Scan

The skill is internally consistent with its stated purpose: it polls the public DexScreener API, stores per-token JSON configs, and optionally sends alerts via Telegram; nothing requested or implemented is disproportionate to that goal.

Purpose & Capability

Name and description (Solana token monitoring using DexScreener) match the code and instructions. Required binary is python3 and the code uses the DexScreener public API and optional Telegram Bot API as advertised — all expected for this functionality.

Instruction Scope

Runtime instructions only run the included monitor.py (setup, check, report, list). The script reads/writes its own config files under ~/.openclaw/workspace/data/token-monitors, polls DexScreener, and optionally posts to Telegram. It does not instruct reading unrelated files, environment secrets, or posting to unexpected endpoints.

Install Mechanism

No install spec — the skill ships a Python script and the SKILL.md/INSTRUCTIONS.md explain how to run it. Nothing is downloaded at runtime beyond API calls to known HTTP endpoints. No archives or third-party installers are used.

Credentials

No required environment variables or external credentials are declared. Telegram bot token and chat ID are optional and only used if the user supplies them via setup; those are stored in the skill's own JSON config. The level and type of credential access is proportional to the described functionality.

Persistence & Privilege

The skill is not forced-always (always: false) and uses normal, self-contained persistence (per-symbol JSON files under the skill's data directory). It does not modify other skills or system settings. Autonomous invocation (agent can run checks during heartbeats) is expected for a monitoring skill.

Assessment

This skill appears to do exactly what it says: poll DexScreener and optionally send Telegram alerts. Before installing, consider: (1) Telegram bot token and chat ID are stored in a JSON file under ~/.openclaw/workspace/data/token-monitors — protect filesystem permissions if you store secrets there; (2) the skill will make outbound HTTP requests to api.dexscreener.com and api.telegram.org during checks; if you want no autonomous network activity, don't enable heartbeat checks or don't configure Telegram; (3) you received the source here — review monitor.py if you want to double-check; (4) if you don't trust the anonymous author, avoid adding Telegram credentials or running the skill with high privileges. Overall, the skill is coherent and proportional to its stated purpose.

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 <CONTRACT_ADDRESS> <SYMBOL>

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 <CONTRACT_ADDRESS> <SYMBOL> --telegram-token <BOT_TOKEN> --chat-id <CHAT_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 <CONTRACT_ADDRESS> <SYMBOL>

# Get a status report
python3 monitor.py report <SYMBOL>

# Check for alerts (run during heartbeat)
python3 monitor.py check <SYMBOL>

# 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.