Mobula - Smart Alerts & Monitoring#

24/7 autonomous crypto monitoring using OpenClaw's heartbeat system. Set conditions once, let your agent monitor continuously and alert you on Telegram/WhatsApp/Discord.

Quick Start#

1. Get your free API key (no credit card required)

• Go to mobula.io and sign up
• Free tier: 100 requests/minute
• Copy your API key from the dashboard

2. Set your API key

bash

export MOBULA_API_KEY="your_api_key_here"

3. Set up monitoring Ask your agent:

• "Alert me if BTC moves more than 5% in 1 hour"
• "Monitor my wallet and alert if any token drops 15%"
• "Watch these whale wallets and alert on large buys"
• "Find new tokens on Base matching my criteria every 6 hours"
• "Send me a market brief every morning at 7am"

---

Security#

✅ Read-only access - No trading, no transactions ✅ No private keys - Only public blockchain data ✅ Open source - View code on GitHub ✅ VirusTotal verified - Benign scan results

---

How It Works#

Unlike ChatGPT/Claude chat, your OpenClaw agent runs continuously. The heartbeat system (~30min intervals) allows your agent to:

1. Check conditions you've set (price thresholds, portfolio changes, whale movements)
2. Fetch data from Mobula API when needed
3. Analyze using multi-condition logic (not just "price > X")
4. Alert you on Telegram/WhatsApp/Discord only when conditions are met

This skill provides monitoring patterns using Mobula endpoints. Combine with mobula-prices and mobula-wallet skills for complete functionality.

---

Monitoring Patterns#

Pattern 1: Portfolio Guardian#

Monitor your wallet 24/7 for concentration risks and drops.

Setup:

"Monitor my wallet 0x... and alert me on Telegram if any token drops more than 15% or my allocation exceeds 40% on one asset. Daily summary at 9am."

How it works:

Every heartbeat (~30min):

1. Fetch portfolio via mobula_wallet_portfolio
2. Calculate allocation percentages
3. Check conditions:
   • Any token >40% of portfolio → suggest rebalancing
   • Any token down >15% in 24h → alert with context
   • Total portfolio changed >10% → notify
4. Store previous values in memory to detect changes
5. Send daily summary at user's preferred time

Example alert:

text

⚠️ Portfolio Alert

Your ETH allocation is now 47% (was 38% yesterday).
Consider rebalancing to reduce concentration risk.

Current holdings:
- ETH: $12,340 (47%)
- BRETT: $8,200 (31%) up 12% 24h
- DEGEN: $5,890 (22%) down 3% 24h

---

Pattern 2: Whale Watching#

Track smart money and get alerted when whales move.

Setup:

"Watch wallets 0xabc, 0xdef, 0x123. Alert if any buy/sell more than $50K. If multiple whales buy the same token within 6h, priority alert with full analysis."

How it works:

Every heartbeat:

1. Check transactions via mobula_wallet_transactions
2. If new significant transaction (>$50K):
   • Get token details via mobula_market_data
   • Check recent trades via mobula_market_trades
   • Cross-check if other tracked whales bought same token
3. If multiple whales buying → priority alert

Example alert:

text

🚨 Whale Alert - HIGH PRIORITY

Wallet 0x742d... bought $150K of BRETT on Base (2h ago)

Token: BRETT | Price: $0.089 (up 23% 24h)
Mcap: $2.3M | Volume: $1.2M (8x normal)

Cross-signal: 2 other tracked whales also bought BRETT:
- 0x888... bought $80K (4h ago)
- 0x111... bought $120K (1h ago)

⚠️ Possible coordinated accumulation.

---

Pattern 3: Token Scout (Autonomous Discovery)#

Agent autonomously finds new tokens matching your criteria.

Setup:

"Find tokens on Base/Arbitrum every 6h: mcap under $5M, liquidity over $100K, volume up 50%+ 24h, verified contract. Send top 3 with analysis."

How it works:

Every 4-6 hours on heartbeat:

1. User defines criteria (stored in memory):
   • Chains: Base, Arbitrum
   • Market cap: <$5M
   • Liquidity: >$100K
   • Volume change 24h: >+50%
2. Search/filter tokens via mobula_market_data
3. For each match:
   • Get 7-day history via mobula_market_history
   • Check metadata via mobula_metadata
   • Calculate risk score
4. Send top 3 with analysis

Example alert:

text

🔍 Token Scout - 3 New Matches

1. BOOP on Base
   - Price: $0.0042 (up 156% 24h, up 340% 7d)
   - Mcap: $2.1M | Liquidity: $280K
   - Volume: $890K (12x average)
   - Contract: Verified ✅
   - Risk: Medium

2. ZORP on Arbitrum
   - Price: $0.0089 (up 78% 24h)
   - Mcap: $3.4M | Liquidity: $450K
   - Whale buy: $60K (3h ago)
   - Risk: Medium-High

3. [...]

---

Pattern 4: Smart Price Alerts#

Contextual alerts with multi-condition logic (not just "price > X").

Setup:

"Alert me if BTC moves more than 5% in 1 hour, BUT only if volume is 2x above 24h average. Real moves, not noise."

How it works:

Every heartbeat:

1. Get current price and volume via mobula_market_data
2. Compare to price from 1 hour ago (stored in memory)
3. Check if volume condition met
4. Only alert if BOTH conditions true

Other smart alert examples:

• "Alert if ETH breaks $4K after consolidating $3,800-$3,950 for 3+ days"
• "Alert if any of my watchlist tokens pump >20% with volume >5x average"
• "Alert if BTC drops >3% but ETH is green (divergence signal)"

---

Pattern 5: Market Brief#

Automated morning/evening market overviews.

Setup:

"Send market overview at 7am and 7pm on Telegram. Include BTC, ETH, SOL, and any top 100 token that moved more than 10%."

How it works:

Every scheduled time (7am, 7pm):

1. Check major tokens (BTC, ETH, SOL, BNB) via mobula_market_multi
2. Identify major moves (>5% in 24h)
3. Check volume leaders
4. Provide concise overview

Example brief:

text

📊 Crypto Market Brief - Feb 20, 7:00 AM

Majors:
- BTC: $67,234 (up 2.1% 24h)
- ETH: $3,456 (up 4.3% 24h)
- SOL: $123.45 (down 1.2% 24h)

Big Movers (24h):
- PEPE: up 23%
- ARB: up 15%
- AVAX: down 12%

Sentiment: Cautiously bullish. ETH leading, memes pumping.

---

Setting Up Heartbeat Monitoring#

Step 1: Tell your agent what to monitor

Be specific about:

• What to track (wallets, tokens, conditions)
• When to alert (thresholds, multi-condition logic)
• How often to check (30min, 1h, 6h)
• Where to alert (Telegram, Discord, WhatsApp)

Step 2: Agent stores config in memory

Your agent remembers:

• Monitoring tasks
• Previous values (for change detection)
• Alert preferences
• Scheduling

Step 3: Agent monitors on heartbeat

Every heartbeat interval:

• Fetches only necessary data (respects rate limits)
• Compares to previous values
• Evaluates conditions
• Sends alerts when triggered

---

Combining Endpoints for Rich Analysis#

Full Token Analysis#

User asks: "Should I buy this token?"

1. mobula_market_data → current price, mcap, volume, liquidity
2. mobula_market_history → 7d and 30d trend
3. mobula_market_trades → recent activity (accumulation or distribution?)
4. mobula_metadata → project info, socials, verification

Response format:

text

TOKEN Analysis

Price: $0.042 (down 8% 24h, up 156% 7d)
- Near 7d high, down from $0.051
- Still up 400% from 30d low

Fundamentals:
- Mcap: $2.1M (small cap, high risk/reward)
- Liquidity: $280K (decent for size)
- Volume: $1.2M 24h (healthy)

On-chain:
- Recent trades show buying pressure (3:1 buy/sell ratio)
- 2 large buys ($50K+) in last 2h

Project:
- Contract verified ✅
- Active Twitter (12K followers)

Risk: Small cap, high volatility. Don't ape more than you can lose.

---

Authentication#

All requests require your API key in the Authorization header:

text

Authorization: ${MOBULA_API_KEY}

If authentication fails (401/403):

• Verify: echo $MOBULA_API_KEY
• Regenerate at mobula.io if expired
• Check rate limits (100 req/min free tier)

---

Rate Limits & Best Practices#

Respect Rate Limits#

• Free tier: 100 requests/minute
• Use mobula_market_multi for batch queries
• Cache data in memory (metadata doesn't change often)

Efficient Heartbeat Usage#

• Don't call every endpoint on every heartbeat
• Only fetch what's needed based on active monitoring
• Batch requests when possible
• Store previous values to detect changes

---

Error Handling#

API Key Issues:

• "I need a Mobula API key. Get one free at https://mobula.io then set it: export MOBULA_API_KEY='your_key'"
• "Invalid API key. Check it at https://mobula.io"
• "Rate limit hit. Upgrade at https://mobula.io or retry later"

Monitoring Setup:

• "What conditions should I monitor for?"
• "How often should I check? (30min, 1h, 6h)"
• "Where should I send alerts? (Telegram, Discord, WhatsApp)"

---

When to Use This Skill#

✅ USE WHEN the user:

• Wants to set up alerts or monitoring
• Asks for 24/7 tracking
• Wants autonomous discovery
• Needs scheduled reports or briefs
• Mentions "alert me when", "monitor", "track", "watch"

❌ DON'T USE WHEN:

• User wants one-time price check (use mobula-prices)
• User wants to check portfolio once (use mobula-wallet)

---

Related Skills#

• mobula-prices - Token prices and market data (required for alerts)
• mobula-wallet - Portfolio tracking (required for wallet monitoring)

---

Ready-to-Use Templates#

Copy these templates to ~/openclaw/heartbeat/:

• heartbeat-portfolio-guardian.md
• heartbeat-whale-tracker.md
• heartbeat-token-scout.md
• heartbeat-market-brief.md

---

Resources#

• Get API Key: mobula.io
• API Docs: docs.mobula.io
• GitHub: Mobula OpenClaw Skills
• Support: Open issue on GitHub

---

Version History#

1.0.0 (2024-03-25): Initial release

• Portfolio guardian pattern
• Whale watching pattern
• Autonomous token scout
• Smart price alerts
• Market brief automation
• Heartbeat optimization tips