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

• 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)

Core Capabilities

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"

• 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

• "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?"

• 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)

• 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)

• "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"

• 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

• Array of price points with timestamps
• Volume at each point
• Market cap at each point

• "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"

• 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)

• 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

• "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?"

• 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)

• Array of transactions:
• Type (swap, transfer, mint, burn)
• Tokens involved (from/to)
• Amounts
• USD values at time of transaction
• Timestamp
• Chain
• Transaction hash

• "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"

• 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

• Same data as mobula_market_data but for multiple tokens
• Efficient for portfolio analysis, watchlists, market overviews

• "Compare BTC, ETH, and SOL performance today"
• "Show me the top movers from my watchlist"
• "Get prices for these 10 tokens: [list]"

• 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

• Name, symbol, logo
• Description
• Website, Twitter, Telegram, Discord links
• Contract addresses across all chains
• Launch date
• Categories/tags

• "Tell me about this token"
• "What's the website for this project?"
• "Where can I find their community?"

• 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

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

Combining Multiple Endpoints for Rich Insights

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

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.

Response Formatting Guidelines

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

Common User Requests & How to Handle

"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

Error Handling

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?"

Rate Limits & Best Practices

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