Mobula - Crypto Market Data & Wallet Intelligence

Mobula - Multi-Chain Crypto Data Intelligence

Real-time crypto market data, wallet tracking, and on-chain analytics across 88+ blockchains. Oracle-grade pricing trusted by Chainlink, Supra, and API3.

When to Use This Skill

USE WHEN the user: Asks about any token price, volume, market cap, or price change Wants to check a wallet's holdings or portfolio value Needs historical price data for charts or analysis Mentions a contract address and wants token info Asks about tokens on specific chains (Base, Arbitrum, Solana, etc.) Wants cross-chain portfolio overview Needs batch data on multiple tokens at once Asks about token liquidity, ATH, ATL, or trading volume Wants to track whale wallets or monitor significant transactions Needs to find new tokens matching specific criteria DON'T USE WHEN: User wants to execute trades (use bankr skill instead) User wants DEX swap quotes (use defi skill) User wants exchange-specific data (use okx/binance skills)

1. Market Data (mobula_market_data)

Endpoint: GET https://api.mobula.io/api/1/market/data Get real-time price, volume, market cap, and liquidity for any token across all supported chains. Parameters: asset (required): Token name, symbol, or contract address Examples: "Bitcoin", "ETH", "0x532f27101965dd16442e59d40670faf5ebb142e4" blockchain (optional): Specific chain to query Examples: "base", "arbitrum", "ethereum", "solana", "polygon" Returns: Current price (USD) Price changes: 1h, 24h, 7d, 30d (percentage and absolute) Volume (24h) Market cap Fully diluted valuation Liquidity All-time high (ATH) and all-time low (ATL) with dates Total supply, circulating supply Usage examples: "What's the price of Bitcoin?" "Show me BRETT's market data on Base" "Get data for contract 0x532f27101965dd16442e59d40670faf5ebb142e4" "Is ETH pumping or dumping right now?" "What's the market cap of PEPE?" When to use: User asks for price of any token User wants to know if something is pumping/dumping Analyzing token fundamentals (mcap, liquidity, volume) Comparing tokens Setting up price alerts

2. Wallet Portfolio (mobula_wallet_portfolio)

Endpoint: GET https://api.mobula.io/api/1/wallet/portfolio Get complete portfolio for any wallet across all 88 chains in a single call. Parameters: wallet (required): Wallet address Format: "0x..." or ENS name (e.g., "vitalik.eth") blockchains (optional): Comma-separated list to filter specific chains Default: all chains cache (optional): Use cached data (faster, slightly less fresh) Returns: All tokens held with: Token name, symbol, address Balance (amount and USD value) Current price Price change 24h Estimated profit/loss Chain Total portfolio value (USD) Portfolio allocation by token (percentages) NFTs (if present) Usage examples: "Show the portfolio for wallet 0x123..." "What tokens does vitalik.eth hold?" "Check my wallet balance" "What's the total value of this wallet?" "Show me the top 5 holdings in this wallet" When to use: Portfolio tracking Wallet analysis Checking holdings before/after trades Monitoring allocation Setting up portfolio alerts

3. Historical Price Data (mobula_market_history)

Endpoint: GET https://api.mobula.io/api/1/market/history Get historical price data for any token with flexible timeframes. Parameters: asset (required): Token name, symbol, or address from (optional): Start timestamp (Unix seconds) to (optional): End timestamp (Unix seconds) period (optional): Data granularity Options: "1h", "1d", "1w" Default: auto-selected based on timeframe Returns: Array of price points with timestamps Volume at each point Market cap at each point Usage examples: "Show me ETH price for the last 30 days" "What was this token's price on January 1st?" "Has this token been pumping or dumping this week?" "Chart the price movement of BTC in the last 7 days" When to use: Analyzing trends Calculating historical PnL Comparing price action across timeframes Identifying patterns (breakouts, supports, resistance)

4. Recent Trades (mobula_market_trades)

Endpoint: GET https://api.mobula.io/api/1/market/trades Live trade feed for any token across all DEXs and chains. Parameters: asset (required): Token name, symbol, or address limit (optional): Number of trades to return (default: 50, max: 300) Returns: Array of recent trades with: Timestamp Type (buy/sell) Amount (tokens and USD) Price at trade Wallet address (buyer/seller) DEX and chain Transaction hash Usage examples: "Show recent trades for this token" "Who's buying PEPE right now?" "Any whale movements on this token?" "What's the last 10 trades on this token?" When to use: Whale watching Detecting unusual activity (large buys/sells) Volume verification Sentiment analysis (more buys vs sells)

5. Wallet Transaction History (mobula_wallet_transactions)

Endpoint: GET https://api.mobula.io/api/1/wallet/transactions Full transaction history for any wallet across all chains. Parameters: wallet (required): Wallet address from (optional): Start timestamp to (optional): End timestamp asset (optional): Filter by specific token limit (optional): Number of transactions (default: 100) Returns: Array of transactions: Type (swap, transfer, mint, burn) Tokens involved (from/to) Amounts USD values at time of transaction Timestamp Chain Transaction hash Usage examples: "What did this wallet buy recently?" "Show me the last 10 transactions for 0x123..." "When did this wallet last sell ETH?" "Track this whale's activity" When to use: Wallet monitoring Whale tracking Pattern detection (what they buy/sell) Transaction verification

6. Multi-Asset Data (mobula_market_multi)

Endpoint: GET https://api.mobula.io/api/1/market/multi-data Get market data for multiple tokens in a single request (batch endpoint). Parameters: assets (required): Comma-separated list of token names/symbols/addresses Example: "Bitcoin,Ethereum,Solana" or "BTC,ETH,SOL" Max: 500 tokens per request Returns: Same data as mobula_market_data but for multiple tokens Efficient for portfolio analysis, watchlists, market overviews Usage examples: "Compare BTC, ETH, and SOL performance today" "Show me the top movers from my watchlist" "Get prices for these 10 tokens: [list]" When to use: Portfolio valuation Watchlist updates Market overview (top coins) Batch price checks

7. Token Metadata (mobula_metadata)

Endpoint: GET https://api.mobula.io/api/1/metadata Get detailed metadata for any token. Parameters: asset (required): Token name, symbol, or address Returns: Name, symbol, logo Description Website, Twitter, Telegram, Discord links Contract addresses across all chains Launch date Categories/tags Usage examples: "Tell me about this token" "What's the website for this project?" "Where can I find their community?" When to use: Research on new tokens Verifying legitimacy Finding official links

Authentication

Required: All API requests require authentication via API key. Setup: Get a free API key at https://mobula.io (100 requests/minute free tier) Set environment variable: export MOBULA_API_KEY="your_key_here" Restart OpenClaw agent Header format: Authorization: ${MOBULA_API_KEY} If authentication fails (401/403): Verify key is set: echo $MOBULA_API_KEY Regenerate key at https://mobula.io if expired Check rate limits (100 req/min free, upgrade for more)

Privacy & Security

IMPORTANT - Read Before Using:

What This Skill Accesses

Public blockchain data only: Wallet addresses, token prices, transaction history No private keys: Never provide private keys, seed phrases, or passwords to this skill No sensitive credentials: Skill only requires Mobula API key (public data access)

Wallet Address Privacy

Wallet addresses queried via this skill are sent to Mobula's API (https://api.mobula.io) Querying a wallet address reveals its holdings publicly (on-chain data is already public) Only use public wallet addresses you're comfortable sharing Never enter addresses you want to keep private or that link to your identity

API Key Scope

Mobula API keys provide read-only access to public blockchain data Keys can be scoped, rotated, and revoked at https://mobula.io Free tier: 100 requests/minute Consider using a separate API key for testing vs production

Data Retention

Mobula may log API requests for analytics and rate limiting Refer to Mobula's privacy policy: https://mobula.io/privacy Do not query wallets or data you consider sensitive

Best Practices

Use throwaway/test API keys for initial testing Only query public wallet addresses (e.g., vitalik.eth, well-known addresses) Avoid querying your personal wallets if you want privacy Rotate API keys periodically Monitor rate limits and usage at https://mobula.io

Smart Monitoring Patterns with Heartbeat

OpenClaw's heartbeat system checks conditions every ~30 minutes. Use this for proactive monitoring.

Pattern 1: Portfolio Guardian

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

Pattern 2: Whale Watching

Every heartbeat: Check transactions for tracked wallets via mobula_wallet_transactions 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 the same token If multiple whales buying → priority alert

Pattern 3: Token Scout (Autonomous Discovery)

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

Pattern 4: Smart Price Alerts

Instead of simple "price > X" alerts, create contextual ones: Example: "Alert me if Bitcoin moves >5% in 1 hour BUT only if volume is 2x above 24h average" Every heartbeat: Get current price and volume via mobula_market_data Compare to price from 1 hour ago (stored in memory) Check if volume condition met Only alert if BOTH conditions true

Example: Full Token Analysis

• User asks: "Should I buy this token?"
• mobula_market_data → current price, mcap, volume, liquidity
• mobula_market_history → 7d and 30d trend
• mobula_market_trades → recent activity (accumulation or distribution?)
• mobula_metadata → project info, socials, contract verification
• Response format:
• 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.

Prices

Always show direction: "up 12.4%" or "down 3.2%" Include timeframe: "up 12.4% (24h)" Add context: "Price $0.042 (up 12% 24h, down 8% from ATH)"

Large Numbers

Format clearly: "$1.23M", "$456K", "$45.6B" Not: "$1234567"

Percentages

Use for allocations: "ETH: 42% of portfolio" Use for changes: "down 15.3% in 24h"

Context is Key

Don't just say "price is $0.003" Say: "Price $0.003 (down 8% 24h, down 65% from ATH of $0.089 on Dec 1st, but up 12% from 7d low)"

"Set up alerts for [token]"

Acknowledge the request Ask for specific conditions (price threshold? percentage move? volume spike?) Confirm you'll monitor via heartbeat Store the alert config in memory Confirm: "I'll check [token] every 30min and alert you on [channel] if [condition]"

"Track this wallet"

Add wallet to monitoring list Ask what to watch for: All activity? Only large trades (>$X)? Specific tokens? Store in memory Confirm monitoring is active

"Find tokens matching [criteria]"

Clarify criteria: Chains? Market cap range? Volume requirements? Liquidity minimum? Set up periodic checks (suggest 4-6h interval) Ask how many results they want Start monitoring on next heartbeat

"What's happening in crypto right now?"

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

API Key Issues

No key set: "I need a Mobula API key to fetch crypto data. Get one free at https://mobula.io then add it to your environment with export MOBULA_API_KEY='your_key'" Invalid key: "Your API key seems invalid. Please check it at https://mobula.io" Rate limited: "You've hit the API rate limit. Upgrade your plan at https://mobula.io for higher limits, or I'll retry in a few minutes."

Token Not Found

"I couldn't find that token by name. Could you provide the contract address? Or check the spelling?" Suggest similar tokens if possible Offer to search by contract address

Wallet Issues

Invalid address: "That doesn't look like a valid wallet address. Should be 0x... (42 characters) or an ENS name like vitalik.eth" No activity: "This wallet has no activity or balance. Is this the correct address and chain?"

Respect Rate Limits

Free tier: 100 requests/minute Use mobula_market_multi for batch queries instead of multiple mobula_market_data calls Cache data in memory when appropriate (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 tasks Batch requests when possible Store previous values to detect changes

Supported Blockchains

88+ chains including: Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Solana, Fantom, Cronos, and many more. Full list: https://docs.mobula.io/blockchains

Resources

Mobula Website: https://mobula.io API Documentation: https://docs.mobula.io Skill Repository: https://github.com/Flotapponnier/Crypto-date-openclaw Support: Open an issue on GitHub or visit Mobula Discord

Version History

1.0.1 (2024-02-20): Security & clarity improvements Added comprehensive Privacy & Security section Clarified API key requirement (removed confusing "No API key needed for dev/testing") Enhanced authentication documentation Added best practices for API key management Explicit warnings about wallet address privacy 1.0.0 (2024-02-20): Initial release 7 core endpoints (market data, portfolio, history, trades, transactions, multi-data, metadata) Heartbeat monitoring patterns Smart alert examples Comprehensive documentation