Mobula

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)

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"

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:

1. Get a free API key at https://mobula.io (100 requests/minute free tier)
2. Set environment variable:

   export MOBULA_API_KEY="your_key_here"

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

1. Use throwaway/test API keys for initial testing
2. Only query public wallet addresses (e.g., vitalik.eth, well-known addresses)
3. Avoid querying your personal wallets if you want privacy
4. Rotate API keys periodically
5. 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.