Mobula - Wallet Portfolio & Transactions

Track wallet portfolios and analyze transaction history across 88+ blockchains in real-time. Perfect for portfolio tracking, whale watching, and wallet analytics.

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

export MOBULA_API_KEY="your_api_key_here"

3. Try it

Ask your agent:

• "Show portfolio for wallet 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
• "What tokens does vitalik.eth hold?"
• "Check my wallet balance"
• "What did this wallet buy recently?"
• "Track this whale's activity"

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

⚠️ Privacy Note:

• Only query public wallet addresses (e.g., vitalik.eth, well-known addresses)
• Wallet addresses are sent to Mobula's API for analysis
• On-chain data is already public, but querying it reveals your interest
• Don't query wallets you want to keep private

What This Skill Does

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

Parameters:

• wallet (required): Wallet address or ENS name
• Format: "0x..." or "vitalik.eth"
• blockchains (optional): Filter specific chains (comma-separated)
• 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)

Example prompts:

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

Use cases:

• Portfolio tracking
• Wallet analysis
• Checking holdings before/after trades
• Monitoring allocation
• Setting up portfolio alerts

Wallet Transactions (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 (Unix seconds)
• to (optional): End timestamp (Unix seconds)
• 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

Example prompts:

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

Use cases:

• Wallet monitoring
• Whale tracking
• Pattern detection (what they buy/sell)
• Transaction verification
• Analyzing trading strategies

Authentication

All requests require your API key in the Authorization header:

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)

Response Formatting Tips

Portfolio Overview

Total Portfolio: $24,430

Holdings:
1. ETH: $12,340 (47%) — up 4% 24h
2. BRETT: $8,200 (31%) — up 12% 24h
3. DEGEN: $5,890 (22%) — down 3% 24h

⚠️ ETH allocation is high (47%). Consider rebalancing.

Transaction History

Recent Activity:

2h ago: Bought $150K BRETT on Base
- Price: $0.089 (now up 23%)
- Size: Large buy (whale signal)

4h ago: Sold $80K ETH on Ethereum
- Price: $3,456

Note: Wallet has rotated from ETH to BRETT.

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 in a few minutes"

Wallet Issues:

• "Invalid wallet address. Should be 0x... (42 characters) or ENS name like vitalik.eth"
• "This wallet has no activity or balance. Is this the correct address and chain?"

Common Use Cases

Portfolio Guardian Pattern

Monitor your wallet 24/7 and get alerts on concentration risks:

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
• Total portfolio changed >10% → notify
4. Store previous values to detect changes
5. Send daily summary

Example prompt:

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

Whale Watching Pattern

Track smart money movements:

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

Example prompt:

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

Rate Limits

• Free tier: 100 requests/minute
• Cache portfolio data when possible (doesn't change every second)
• Upgrade at mobula.io for higher limits

Supported Blockchains

88+ chains including:

• Ethereum, Base, Arbitrum, Optimism, Polygon
• BNB Chain, Avalanche, Solana, Fantom, Cronos
• And many more...

Full list: docs.mobula.io/blockchains

When to Use This Skill

✅ USE WHEN the user:

• Asks to check a wallet's holdings or portfolio value
• Wants cross-chain portfolio overview
• Wants to track whale wallets or monitor transactions
• Needs transaction history for analysis
• Asks about wallet activity or trading patterns

❌ DON'T USE WHEN:

• User wants token prices only (use mobula-prices skill)
• User wants to execute trades (use trading skills)
• User wants swap quotes (use DEX skills)

Related Skills

• mobula-prices - Token prices and market data
• mobula-alerts - Smart monitoring and price alerts

Resources

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

Version History

1.0.0 (2024-03-25): Initial release

• Wallet portfolio tracking across all chains
• Transaction history analysis
• Whale watching support
• Privacy guidelines