{
  "schemaVersion": "1.0",
  "item": {
    "slug": "mobula",
    "name": "Mobula - Crypto Market Data & Wallet Intelligence",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Flotapponnier/mobula",
    "canonicalUrl": "https://clawhub.ai/Flotapponnier/mobula",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/mobula",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mobula",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/mobula"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/mobula",
    "agentPageUrl": "https://openagent3.xyz/skills/mobula/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mobula/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mobula/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Mobula - Multi-Chain Crypto Data Intelligence",
        "body": "Real-time crypto market data, wallet tracking, and on-chain analytics across 88+ blockchains. Oracle-grade pricing trusted by Chainlink, Supra, and API3."
      },
      {
        "title": "When to Use This Skill",
        "body": "USE WHEN the user:\n\nAsks about any token price, volume, market cap, or price change\nWants to check a wallet's holdings or portfolio value\nNeeds historical price data for charts or analysis\nMentions a contract address and wants token info\nAsks about tokens on specific chains (Base, Arbitrum, Solana, etc.)\nWants cross-chain portfolio overview\nNeeds batch data on multiple tokens at once\nAsks about token liquidity, ATH, ATL, or trading volume\nWants to track whale wallets or monitor significant transactions\nNeeds to find new tokens matching specific criteria\n\nDON'T USE WHEN:\n\nUser wants to execute trades (use bankr skill instead)\nUser wants DEX swap quotes (use defi skill)\nUser wants exchange-specific data (use okx/binance skills)"
      },
      {
        "title": "1. Market Data (mobula_market_data)",
        "body": "Endpoint: GET https://api.mobula.io/api/1/market/data\n\nGet real-time price, volume, market cap, and liquidity for any token across all supported chains.\n\nParameters:\n\nasset (required): Token name, symbol, or contract address\n\nExamples: \"Bitcoin\", \"ETH\", \"0x532f27101965dd16442e59d40670faf5ebb142e4\"\n\n\nblockchain (optional): Specific chain to query\n\nExamples: \"base\", \"arbitrum\", \"ethereum\", \"solana\", \"polygon\"\n\nReturns:\n\nCurrent price (USD)\nPrice changes: 1h, 24h, 7d, 30d (percentage and absolute)\nVolume (24h)\nMarket cap\nFully diluted valuation\nLiquidity\nAll-time high (ATH) and all-time low (ATL) with dates\nTotal supply, circulating supply\n\nUsage examples:\n\n\"What's the price of Bitcoin?\"\n\"Show me BRETT's market data on Base\"\n\"Get data for contract 0x532f27101965dd16442e59d40670faf5ebb142e4\"\n\"Is ETH pumping or dumping right now?\"\n\"What's the market cap of PEPE?\"\n\nWhen to use:\n\nUser asks for price of any token\nUser wants to know if something is pumping/dumping\nAnalyzing token fundamentals (mcap, liquidity, volume)\nComparing tokens\nSetting up price alerts"
      },
      {
        "title": "2. Wallet Portfolio (mobula_wallet_portfolio)",
        "body": "Endpoint: GET https://api.mobula.io/api/1/wallet/portfolio\n\nGet complete portfolio for any wallet across all 88 chains in a single call.\n\nParameters:\n\nwallet (required): Wallet address\n\nFormat: \"0x...\" or ENS name (e.g., \"vitalik.eth\")\n\n\nblockchains (optional): Comma-separated list to filter specific chains\n\nDefault: all chains\n\n\ncache (optional): Use cached data (faster, slightly less fresh)\n\nReturns:\n\nAll tokens held with:\n\nToken name, symbol, address\nBalance (amount and USD value)\nCurrent price\nPrice change 24h\nEstimated profit/loss\nChain\n\n\nTotal portfolio value (USD)\nPortfolio allocation by token (percentages)\nNFTs (if present)\n\nUsage examples:\n\n\"Show the portfolio for wallet 0x123...\"\n\"What tokens does vitalik.eth hold?\"\n\"Check my wallet balance\"\n\"What's the total value of this wallet?\"\n\"Show me the top 5 holdings in this wallet\"\n\nWhen to use:\n\nPortfolio tracking\nWallet analysis\nChecking holdings before/after trades\nMonitoring allocation\nSetting up portfolio alerts"
      },
      {
        "title": "3. Historical Price Data (mobula_market_history)",
        "body": "Endpoint: GET https://api.mobula.io/api/1/market/history\n\nGet historical price data for any token with flexible timeframes.\n\nParameters:\n\nasset (required): Token name, symbol, or address\nfrom (optional): Start timestamp (Unix seconds)\nto (optional): End timestamp (Unix seconds)\nperiod (optional): Data granularity\n\nOptions: \"1h\", \"1d\", \"1w\"\nDefault: auto-selected based on timeframe\n\nReturns:\n\nArray of price points with timestamps\nVolume at each point\nMarket cap at each point\n\nUsage examples:\n\n\"Show me ETH price for the last 30 days\"\n\"What was this token's price on January 1st?\"\n\"Has this token been pumping or dumping this week?\"\n\"Chart the price movement of BTC in the last 7 days\"\n\nWhen to use:\n\nAnalyzing trends\nCalculating historical PnL\nComparing price action across timeframes\nIdentifying patterns (breakouts, supports, resistance)"
      },
      {
        "title": "4. Recent Trades (mobula_market_trades)",
        "body": "Endpoint: GET https://api.mobula.io/api/1/market/trades\n\nLive trade feed for any token across all DEXs and chains.\n\nParameters:\n\nasset (required): Token name, symbol, or address\nlimit (optional): Number of trades to return (default: 50, max: 300)\n\nReturns:\n\nArray of recent trades with:\n\nTimestamp\nType (buy/sell)\nAmount (tokens and USD)\nPrice at trade\nWallet address (buyer/seller)\nDEX and chain\nTransaction hash\n\nUsage examples:\n\n\"Show recent trades for this token\"\n\"Who's buying PEPE right now?\"\n\"Any whale movements on this token?\"\n\"What's the last 10 trades on this token?\"\n\nWhen to use:\n\nWhale watching\nDetecting unusual activity (large buys/sells)\nVolume verification\nSentiment analysis (more buys vs sells)"
      },
      {
        "title": "5. Wallet Transaction History (mobula_wallet_transactions)",
        "body": "Endpoint: GET https://api.mobula.io/api/1/wallet/transactions\n\nFull transaction history for any wallet across all chains.\n\nParameters:\n\nwallet (required): Wallet address\nfrom (optional): Start timestamp\nto (optional): End timestamp\nasset (optional): Filter by specific token\nlimit (optional): Number of transactions (default: 100)\n\nReturns:\n\nArray of transactions:\n\nType (swap, transfer, mint, burn)\nTokens involved (from/to)\nAmounts\nUSD values at time of transaction\nTimestamp\nChain\nTransaction hash\n\nUsage examples:\n\n\"What did this wallet buy recently?\"\n\"Show me the last 10 transactions for 0x123...\"\n\"When did this wallet last sell ETH?\"\n\"Track this whale's activity\"\n\nWhen to use:\n\nWallet monitoring\nWhale tracking\nPattern detection (what they buy/sell)\nTransaction verification"
      },
      {
        "title": "6. Multi-Asset Data (mobula_market_multi)",
        "body": "Endpoint: GET https://api.mobula.io/api/1/market/multi-data\n\nGet market data for multiple tokens in a single request (batch endpoint).\n\nParameters:\n\nassets (required): Comma-separated list of token names/symbols/addresses\n\nExample: \"Bitcoin,Ethereum,Solana\" or \"BTC,ETH,SOL\"\nMax: 500 tokens per request\n\nReturns:\n\nSame data as mobula_market_data but for multiple tokens\nEfficient for portfolio analysis, watchlists, market overviews\n\nUsage examples:\n\n\"Compare BTC, ETH, and SOL performance today\"\n\"Show me the top movers from my watchlist\"\n\"Get prices for these 10 tokens: [list]\"\n\nWhen to use:\n\nPortfolio valuation\nWatchlist updates\nMarket overview (top coins)\nBatch price checks"
      },
      {
        "title": "7. Token Metadata (mobula_metadata)",
        "body": "Endpoint: GET https://api.mobula.io/api/1/metadata\n\nGet detailed metadata for any token.\n\nParameters:\n\nasset (required): Token name, symbol, or address\n\nReturns:\n\nName, symbol, logo\nDescription\nWebsite, Twitter, Telegram, Discord links\nContract addresses across all chains\nLaunch date\nCategories/tags\n\nUsage examples:\n\n\"Tell me about this token\"\n\"What's the website for this project?\"\n\"Where can I find their community?\"\n\nWhen to use:\n\nResearch on new tokens\nVerifying legitimacy\nFinding official links"
      },
      {
        "title": "Authentication",
        "body": "Required: All API requests require authentication via API key.\n\nSetup:\n\nGet a free API key at https://mobula.io (100 requests/minute free tier)\nSet environment variable:\nexport MOBULA_API_KEY=\"your_key_here\"\n\n\nRestart OpenClaw agent\n\nHeader format:\n\nAuthorization: ${MOBULA_API_KEY}\n\nIf authentication fails (401/403):\n\nVerify key is set: echo $MOBULA_API_KEY\nRegenerate key at https://mobula.io if expired\nCheck rate limits (100 req/min free, upgrade for more)"
      },
      {
        "title": "Privacy & Security",
        "body": "IMPORTANT - Read Before Using:"
      },
      {
        "title": "What This Skill Accesses",
        "body": "Public blockchain data only: Wallet addresses, token prices, transaction history\nNo private keys: Never provide private keys, seed phrases, or passwords to this skill\nNo sensitive credentials: Skill only requires Mobula API key (public data access)"
      },
      {
        "title": "Wallet Address Privacy",
        "body": "Wallet addresses queried via this skill are sent to Mobula's API (https://api.mobula.io)\nQuerying a wallet address reveals its holdings publicly (on-chain data is already public)\nOnly use public wallet addresses you're comfortable sharing\nNever enter addresses you want to keep private or that link to your identity"
      },
      {
        "title": "API Key Scope",
        "body": "Mobula API keys provide read-only access to public blockchain data\nKeys can be scoped, rotated, and revoked at https://mobula.io\nFree tier: 100 requests/minute\nConsider using a separate API key for testing vs production"
      },
      {
        "title": "Data Retention",
        "body": "Mobula may log API requests for analytics and rate limiting\nRefer to Mobula's privacy policy: https://mobula.io/privacy\nDo not query wallets or data you consider sensitive"
      },
      {
        "title": "Best Practices",
        "body": "Use throwaway/test API keys for initial testing\nOnly query public wallet addresses (e.g., vitalik.eth, well-known addresses)\nAvoid querying your personal wallets if you want privacy\nRotate API keys periodically\nMonitor rate limits and usage at https://mobula.io"
      },
      {
        "title": "Smart Monitoring Patterns with Heartbeat",
        "body": "OpenClaw's heartbeat system checks conditions every ~30 minutes. Use this for proactive monitoring."
      },
      {
        "title": "Pattern 1: Portfolio Guardian",
        "body": "Every heartbeat:\n\nFetch user's wallet via mobula_wallet_portfolio\nCalculate allocation percentages\nCheck conditions:\n\nAny token >40% of portfolio → suggest rebalancing\nAny token down >15% in 24h → alert with context\nTotal portfolio changed >10% → notify\n\n\nStore previous values in memory to detect changes\nSend daily summary at user's preferred time"
      },
      {
        "title": "Pattern 2: Whale Watching",
        "body": "Every heartbeat:\n\nCheck transactions for tracked wallets via mobula_wallet_transactions\nIf new significant transaction (>$50K):\n\nGet token details via mobula_market_data\nCheck recent trades via mobula_market_trades\nCross-check if other tracked whales bought the same token\n\n\nIf multiple whales buying → priority alert"
      },
      {
        "title": "Pattern 3: Token Scout (Autonomous Discovery)",
        "body": "Every 4-6 hours on heartbeat:\n\nUser defines criteria (store in memory):\n\nChains: Base, Arbitrum\nMarket cap: <$5M\nLiquidity: >$100K\nVolume change 24h: >+50%\n\n\nSearch/filter tokens via mobula_market_data queries\nFor each match:\n\nGet 7-day history via mobula_market_history\nCheck metadata via mobula_metadata\nCalculate risk score\n\n\nSend top 3 with analysis"
      },
      {
        "title": "Pattern 4: Smart Price Alerts",
        "body": "Instead of simple \"price > X\" alerts, create contextual ones:\n\nExample: \"Alert me if Bitcoin moves >5% in 1 hour BUT only if volume is 2x above 24h average\"\n\nEvery heartbeat:\n\nGet current price and volume via mobula_market_data\nCompare to price from 1 hour ago (stored in memory)\nCheck if volume condition met\nOnly alert if BOTH conditions true"
      },
      {
        "title": "Example: Full Token Analysis",
        "body": "User asks: \"Should I buy this token?\"\n\nmobula_market_data → current price, mcap, volume, liquidity\nmobula_market_history → 7d and 30d trend\nmobula_market_trades → recent activity (accumulation or distribution?)\nmobula_metadata → project info, socials, contract verification\n\nResponse format:\n\nTOKEN Analysis\n\nPrice: $0.042 (down 8% 24h, up 156% 7d)\n- Near 7d high, down from $0.051\n- Still up 400% from 30d low\n\nFundamentals:\n- Mcap: $2.1M (small cap, high risk/reward)\n- Liquidity: $280K (decent for size)\n- Volume: $1.2M 24h (healthy)\n\nOn-chain:\n- Recent trades show buying pressure (3:1 buy/sell ratio)\n- 2 large buys ($50K+) in last 2h\n\nProject:\n- Contract verified\n- Active Twitter (12K followers)\n\nRisk: Small cap, high volatility. Don't ape more than you can lose."
      },
      {
        "title": "Prices",
        "body": "Always show direction: \"up 12.4%\" or \"down 3.2%\"\nInclude timeframe: \"up 12.4% (24h)\"\nAdd context: \"Price $0.042 (up 12% 24h, down 8% from ATH)\""
      },
      {
        "title": "Large Numbers",
        "body": "Format clearly: \"$1.23M\", \"$456K\", \"$45.6B\"\nNot: \"$1234567\""
      },
      {
        "title": "Percentages",
        "body": "Use for allocations: \"ETH: 42% of portfolio\"\nUse for changes: \"down 15.3% in 24h\""
      },
      {
        "title": "Context is Key",
        "body": "Don't just say \"price is $0.003\"\nSay: \"Price $0.003 (down 8% 24h, down 65% from ATH of $0.089 on Dec 1st, but up 12% from 7d low)\""
      },
      {
        "title": "\"Set up alerts for [token]\"",
        "body": "Acknowledge the request\nAsk for specific conditions (price threshold? percentage move? volume spike?)\nConfirm you'll monitor via heartbeat\nStore the alert config in memory\nConfirm: \"I'll check [token] every 30min and alert you on [channel] if [condition]\""
      },
      {
        "title": "\"Track this wallet\"",
        "body": "Add wallet to monitoring list\nAsk what to watch for:\n\nAll activity?\nOnly large trades (>$X)?\nSpecific tokens?\n\n\nStore in memory\nConfirm monitoring is active"
      },
      {
        "title": "\"Find tokens matching [criteria]\"",
        "body": "Clarify criteria:\n\nChains?\nMarket cap range?\nVolume requirements?\nLiquidity minimum?\n\n\nSet up periodic checks (suggest 4-6h interval)\nAsk how many results they want\nStart monitoring on next heartbeat"
      },
      {
        "title": "\"What's happening in crypto right now?\"",
        "body": "Check major tokens (BTC, ETH, SOL, BNB) via mobula_market_multi\nIdentify any major moves (>5% in 24h)\nCheck volume leaders\nProvide concise overview"
      },
      {
        "title": "API Key Issues",
        "body": "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'\"\nInvalid key: \"Your API key seems invalid. Please check it at https://mobula.io\"\nRate 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.\""
      },
      {
        "title": "Token Not Found",
        "body": "\"I couldn't find that token by name. Could you provide the contract address? Or check the spelling?\"\nSuggest similar tokens if possible\nOffer to search by contract address"
      },
      {
        "title": "Wallet Issues",
        "body": "Invalid address: \"That doesn't look like a valid wallet address. Should be 0x... (42 characters) or an ENS name like vitalik.eth\"\nNo activity: \"This wallet has no activity or balance. Is this the correct address and chain?\""
      },
      {
        "title": "Respect Rate Limits",
        "body": "Free tier: 100 requests/minute\nUse mobula_market_multi for batch queries instead of multiple mobula_market_data calls\nCache data in memory when appropriate (metadata doesn't change often)"
      },
      {
        "title": "Efficient Heartbeat Usage",
        "body": "Don't call every endpoint on every heartbeat\nOnly fetch what's needed based on active monitoring tasks\nBatch requests when possible\nStore previous values to detect changes"
      },
      {
        "title": "Supported Blockchains",
        "body": "88+ chains including: Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Solana, Fantom, Cronos, and many more.\n\nFull list: https://docs.mobula.io/blockchains"
      },
      {
        "title": "Resources",
        "body": "Mobula Website: https://mobula.io\nAPI Documentation: https://docs.mobula.io\nSkill Repository: https://github.com/Flotapponnier/Crypto-date-openclaw\nSupport: Open an issue on GitHub or visit Mobula Discord"
      },
      {
        "title": "Version History",
        "body": "1.0.1 (2024-02-20): Security & clarity improvements\n\nAdded comprehensive Privacy & Security section\nClarified API key requirement (removed confusing \"No API key needed for dev/testing\")\nEnhanced authentication documentation\nAdded best practices for API key management\nExplicit warnings about wallet address privacy\n\n\n\n1.0.0 (2024-02-20): Initial release\n\n7 core endpoints (market data, portfolio, history, trades, transactions, multi-data, metadata)\nHeartbeat monitoring patterns\nSmart alert examples\nComprehensive documentation"
      }
    ],
    "body": "Mobula - Multi-Chain Crypto Data Intelligence\n\nReal-time crypto market data, wallet tracking, and on-chain analytics across 88+ blockchains. Oracle-grade pricing trusted by Chainlink, Supra, and API3.\n\nWhen to Use This Skill\n\nUSE WHEN the user:\n\nAsks about any token price, volume, market cap, or price change\nWants to check a wallet's holdings or portfolio value\nNeeds historical price data for charts or analysis\nMentions a contract address and wants token info\nAsks about tokens on specific chains (Base, Arbitrum, Solana, etc.)\nWants cross-chain portfolio overview\nNeeds batch data on multiple tokens at once\nAsks about token liquidity, ATH, ATL, or trading volume\nWants to track whale wallets or monitor significant transactions\nNeeds to find new tokens matching specific criteria\n\nDON'T USE WHEN:\n\nUser wants to execute trades (use bankr skill instead)\nUser wants DEX swap quotes (use defi skill)\nUser wants exchange-specific data (use okx/binance skills)\nCore Capabilities\n1. Market Data (mobula_market_data)\n\nEndpoint: GET https://api.mobula.io/api/1/market/data\n\nGet real-time price, volume, market cap, and liquidity for any token across all supported chains.\n\nParameters:\n\nasset (required): Token name, symbol, or contract address\nExamples: \"Bitcoin\", \"ETH\", \"0x532f27101965dd16442e59d40670faf5ebb142e4\"\nblockchain (optional): Specific chain to query\nExamples: \"base\", \"arbitrum\", \"ethereum\", \"solana\", \"polygon\"\n\nReturns:\n\nCurrent price (USD)\nPrice changes: 1h, 24h, 7d, 30d (percentage and absolute)\nVolume (24h)\nMarket cap\nFully diluted valuation\nLiquidity\nAll-time high (ATH) and all-time low (ATL) with dates\nTotal supply, circulating supply\n\nUsage examples:\n\n\"What's the price of Bitcoin?\"\n\"Show me BRETT's market data on Base\"\n\"Get data for contract 0x532f27101965dd16442e59d40670faf5ebb142e4\"\n\"Is ETH pumping or dumping right now?\"\n\"What's the market cap of PEPE?\"\n\nWhen to use:\n\nUser asks for price of any token\nUser wants to know if something is pumping/dumping\nAnalyzing token fundamentals (mcap, liquidity, volume)\nComparing tokens\nSetting up price alerts\n2. Wallet Portfolio (mobula_wallet_portfolio)\n\nEndpoint: GET https://api.mobula.io/api/1/wallet/portfolio\n\nGet complete portfolio for any wallet across all 88 chains in a single call.\n\nParameters:\n\nwallet (required): Wallet address\nFormat: \"0x...\" or ENS name (e.g., \"vitalik.eth\")\nblockchains (optional): Comma-separated list to filter specific chains\nDefault: all chains\ncache (optional): Use cached data (faster, slightly less fresh)\n\nReturns:\n\nAll tokens held with:\nToken name, symbol, address\nBalance (amount and USD value)\nCurrent price\nPrice change 24h\nEstimated profit/loss\nChain\nTotal portfolio value (USD)\nPortfolio allocation by token (percentages)\nNFTs (if present)\n\nUsage examples:\n\n\"Show the portfolio for wallet 0x123...\"\n\"What tokens does vitalik.eth hold?\"\n\"Check my wallet balance\"\n\"What's the total value of this wallet?\"\n\"Show me the top 5 holdings in this wallet\"\n\nWhen to use:\n\nPortfolio tracking\nWallet analysis\nChecking holdings before/after trades\nMonitoring allocation\nSetting up portfolio alerts\n3. Historical Price Data (mobula_market_history)\n\nEndpoint: GET https://api.mobula.io/api/1/market/history\n\nGet historical price data for any token with flexible timeframes.\n\nParameters:\n\nasset (required): Token name, symbol, or address\nfrom (optional): Start timestamp (Unix seconds)\nto (optional): End timestamp (Unix seconds)\nperiod (optional): Data granularity\nOptions: \"1h\", \"1d\", \"1w\"\nDefault: auto-selected based on timeframe\n\nReturns:\n\nArray of price points with timestamps\nVolume at each point\nMarket cap at each point\n\nUsage examples:\n\n\"Show me ETH price for the last 30 days\"\n\"What was this token's price on January 1st?\"\n\"Has this token been pumping or dumping this week?\"\n\"Chart the price movement of BTC in the last 7 days\"\n\nWhen to use:\n\nAnalyzing trends\nCalculating historical PnL\nComparing price action across timeframes\nIdentifying patterns (breakouts, supports, resistance)\n4. Recent Trades (mobula_market_trades)\n\nEndpoint: GET https://api.mobula.io/api/1/market/trades\n\nLive trade feed for any token across all DEXs and chains.\n\nParameters:\n\nasset (required): Token name, symbol, or address\nlimit (optional): Number of trades to return (default: 50, max: 300)\n\nReturns:\n\nArray of recent trades with:\nTimestamp\nType (buy/sell)\nAmount (tokens and USD)\nPrice at trade\nWallet address (buyer/seller)\nDEX and chain\nTransaction hash\n\nUsage examples:\n\n\"Show recent trades for this token\"\n\"Who's buying PEPE right now?\"\n\"Any whale movements on this token?\"\n\"What's the last 10 trades on this token?\"\n\nWhen to use:\n\nWhale watching\nDetecting unusual activity (large buys/sells)\nVolume verification\nSentiment analysis (more buys vs sells)\n5. Wallet Transaction History (mobula_wallet_transactions)\n\nEndpoint: GET https://api.mobula.io/api/1/wallet/transactions\n\nFull transaction history for any wallet across all chains.\n\nParameters:\n\nwallet (required): Wallet address\nfrom (optional): Start timestamp\nto (optional): End timestamp\nasset (optional): Filter by specific token\nlimit (optional): Number of transactions (default: 100)\n\nReturns:\n\nArray of transactions:\nType (swap, transfer, mint, burn)\nTokens involved (from/to)\nAmounts\nUSD values at time of transaction\nTimestamp\nChain\nTransaction hash\n\nUsage examples:\n\n\"What did this wallet buy recently?\"\n\"Show me the last 10 transactions for 0x123...\"\n\"When did this wallet last sell ETH?\"\n\"Track this whale's activity\"\n\nWhen to use:\n\nWallet monitoring\nWhale tracking\nPattern detection (what they buy/sell)\nTransaction verification\n6. Multi-Asset Data (mobula_market_multi)\n\nEndpoint: GET https://api.mobula.io/api/1/market/multi-data\n\nGet market data for multiple tokens in a single request (batch endpoint).\n\nParameters:\n\nassets (required): Comma-separated list of token names/symbols/addresses\nExample: \"Bitcoin,Ethereum,Solana\" or \"BTC,ETH,SOL\"\nMax: 500 tokens per request\n\nReturns:\n\nSame data as mobula_market_data but for multiple tokens\nEfficient for portfolio analysis, watchlists, market overviews\n\nUsage examples:\n\n\"Compare BTC, ETH, and SOL performance today\"\n\"Show me the top movers from my watchlist\"\n\"Get prices for these 10 tokens: [list]\"\n\nWhen to use:\n\nPortfolio valuation\nWatchlist updates\nMarket overview (top coins)\nBatch price checks\n7. Token Metadata (mobula_metadata)\n\nEndpoint: GET https://api.mobula.io/api/1/metadata\n\nGet detailed metadata for any token.\n\nParameters:\n\nasset (required): Token name, symbol, or address\n\nReturns:\n\nName, symbol, logo\nDescription\nWebsite, Twitter, Telegram, Discord links\nContract addresses across all chains\nLaunch date\nCategories/tags\n\nUsage examples:\n\n\"Tell me about this token\"\n\"What's the website for this project?\"\n\"Where can I find their community?\"\n\nWhen to use:\n\nResearch on new tokens\nVerifying legitimacy\nFinding official links\nAuthentication\n\nRequired: All API requests require authentication via API key.\n\nSetup:\n\nGet a free API key at https://mobula.io (100 requests/minute free tier)\nSet environment variable:\nexport MOBULA_API_KEY=\"your_key_here\"\n\nRestart OpenClaw agent\n\nHeader format:\n\nAuthorization: ${MOBULA_API_KEY}\n\n\nIf authentication fails (401/403):\n\nVerify key is set: echo $MOBULA_API_KEY\nRegenerate key at https://mobula.io if expired\nCheck rate limits (100 req/min free, upgrade for more)\nPrivacy & Security\n\nIMPORTANT - Read Before Using:\n\nWhat This Skill Accesses\nPublic blockchain data only: Wallet addresses, token prices, transaction history\nNo private keys: Never provide private keys, seed phrases, or passwords to this skill\nNo sensitive credentials: Skill only requires Mobula API key (public data access)\nWallet Address Privacy\nWallet addresses queried via this skill are sent to Mobula's API (https://api.mobula.io)\nQuerying a wallet address reveals its holdings publicly (on-chain data is already public)\nOnly use public wallet addresses you're comfortable sharing\nNever enter addresses you want to keep private or that link to your identity\nAPI Key Scope\nMobula API keys provide read-only access to public blockchain data\nKeys can be scoped, rotated, and revoked at https://mobula.io\nFree tier: 100 requests/minute\nConsider using a separate API key for testing vs production\nData Retention\nMobula may log API requests for analytics and rate limiting\nRefer to Mobula's privacy policy: https://mobula.io/privacy\nDo not query wallets or data you consider sensitive\nBest Practices\nUse throwaway/test API keys for initial testing\nOnly query public wallet addresses (e.g., vitalik.eth, well-known addresses)\nAvoid querying your personal wallets if you want privacy\nRotate API keys periodically\nMonitor rate limits and usage at https://mobula.io\nSmart Monitoring Patterns with Heartbeat\n\nOpenClaw's heartbeat system checks conditions every ~30 minutes. Use this for proactive monitoring.\n\nPattern 1: Portfolio Guardian\n\nEvery heartbeat:\n\nFetch user's wallet via mobula_wallet_portfolio\nCalculate allocation percentages\nCheck conditions:\nAny token >40% of portfolio → suggest rebalancing\nAny token down >15% in 24h → alert with context\nTotal portfolio changed >10% → notify\nStore previous values in memory to detect changes\nSend daily summary at user's preferred time\nPattern 2: Whale Watching\n\nEvery heartbeat:\n\nCheck transactions for tracked wallets via mobula_wallet_transactions\nIf new significant transaction (>$50K):\nGet token details via mobula_market_data\nCheck recent trades via mobula_market_trades\nCross-check if other tracked whales bought the same token\nIf multiple whales buying → priority alert\nPattern 3: Token Scout (Autonomous Discovery)\n\nEvery 4-6 hours on heartbeat:\n\nUser defines criteria (store in memory):\nChains: Base, Arbitrum\nMarket cap: <$5M\nLiquidity: >$100K\nVolume change 24h: >+50%\nSearch/filter tokens via mobula_market_data queries\nFor each match:\nGet 7-day history via mobula_market_history\nCheck metadata via mobula_metadata\nCalculate risk score\nSend top 3 with analysis\nPattern 4: Smart Price Alerts\n\nInstead of simple \"price > X\" alerts, create contextual ones:\n\nExample: \"Alert me if Bitcoin moves >5% in 1 hour BUT only if volume is 2x above 24h average\"\n\nEvery heartbeat:\n\nGet current price and volume via mobula_market_data\nCompare to price from 1 hour ago (stored in memory)\nCheck if volume condition met\nOnly alert if BOTH conditions true\nCombining Multiple Endpoints for Rich Insights\nExample: Full Token Analysis\n\nUser asks: \"Should I buy this token?\"\n\nmobula_market_data → current price, mcap, volume, liquidity\nmobula_market_history → 7d and 30d trend\nmobula_market_trades → recent activity (accumulation or distribution?)\nmobula_metadata → project info, socials, contract verification\n\nResponse format:\n\nTOKEN Analysis\n\nPrice: $0.042 (down 8% 24h, up 156% 7d)\n- Near 7d high, down from $0.051\n- Still up 400% from 30d low\n\nFundamentals:\n- Mcap: $2.1M (small cap, high risk/reward)\n- Liquidity: $280K (decent for size)\n- Volume: $1.2M 24h (healthy)\n\nOn-chain:\n- Recent trades show buying pressure (3:1 buy/sell ratio)\n- 2 large buys ($50K+) in last 2h\n\nProject:\n- Contract verified\n- Active Twitter (12K followers)\n\nRisk: Small cap, high volatility. Don't ape more than you can lose.\n\nResponse Formatting Guidelines\nPrices\nAlways show direction: \"up 12.4%\" or \"down 3.2%\"\nInclude timeframe: \"up 12.4% (24h)\"\nAdd context: \"Price $0.042 (up 12% 24h, down 8% from ATH)\"\nLarge Numbers\nFormat clearly: \"$1.23M\", \"$456K\", \"$45.6B\"\nNot: \"$1234567\"\nPercentages\nUse for allocations: \"ETH: 42% of portfolio\"\nUse for changes: \"down 15.3% in 24h\"\nContext is Key\n\nDon'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)\"\n\nCommon User Requests & How to Handle\n\"Set up alerts for [token]\"\nAcknowledge the request\nAsk for specific conditions (price threshold? percentage move? volume spike?)\nConfirm you'll monitor via heartbeat\nStore the alert config in memory\nConfirm: \"I'll check [token] every 30min and alert you on [channel] if [condition]\"\n\"Track this wallet\"\nAdd wallet to monitoring list\nAsk what to watch for:\nAll activity?\nOnly large trades (>$X)?\nSpecific tokens?\nStore in memory\nConfirm monitoring is active\n\"Find tokens matching [criteria]\"\nClarify criteria:\nChains?\nMarket cap range?\nVolume requirements?\nLiquidity minimum?\nSet up periodic checks (suggest 4-6h interval)\nAsk how many results they want\nStart monitoring on next heartbeat\n\"What's happening in crypto right now?\"\nCheck major tokens (BTC, ETH, SOL, BNB) via mobula_market_multi\nIdentify any major moves (>5% in 24h)\nCheck volume leaders\nProvide concise overview\nError Handling\nAPI Key Issues\nNo 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'\"\nInvalid key: \"Your API key seems invalid. Please check it at https://mobula.io\"\nRate 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.\"\nToken Not Found\n\"I couldn't find that token by name. Could you provide the contract address? Or check the spelling?\"\nSuggest similar tokens if possible\nOffer to search by contract address\nWallet Issues\nInvalid address: \"That doesn't look like a valid wallet address. Should be 0x... (42 characters) or an ENS name like vitalik.eth\"\nNo activity: \"This wallet has no activity or balance. Is this the correct address and chain?\"\nRate Limits & Best Practices\nRespect Rate Limits\nFree tier: 100 requests/minute\nUse mobula_market_multi for batch queries instead of multiple mobula_market_data calls\nCache data in memory when appropriate (metadata doesn't change often)\nEfficient Heartbeat Usage\nDon't call every endpoint on every heartbeat\nOnly fetch what's needed based on active monitoring tasks\nBatch requests when possible\nStore previous values to detect changes\nSupported Blockchains\n\n88+ chains including: Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Solana, Fantom, Cronos, and many more.\n\nFull list: https://docs.mobula.io/blockchains\n\nResources\nMobula Website: https://mobula.io\nAPI Documentation: https://docs.mobula.io\nSkill Repository: https://github.com/Flotapponnier/Crypto-date-openclaw\nSupport: Open an issue on GitHub or visit Mobula Discord\nVersion History\n\n1.0.1 (2024-02-20): Security & clarity improvements\n\nAdded comprehensive Privacy & Security section\nClarified API key requirement (removed confusing \"No API key needed for dev/testing\")\nEnhanced authentication documentation\nAdded best practices for API key management\nExplicit warnings about wallet address privacy\n\n1.0.0 (2024-02-20): Initial release\n\n7 core endpoints (market data, portfolio, history, trades, transactions, multi-data, metadata)\nHeartbeat monitoring patterns\nSmart alert examples\nComprehensive documentation"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Flotapponnier/mobula",
    "publisherUrl": "https://clawhub.ai/Flotapponnier/mobula",
    "owner": "Flotapponnier",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/mobula",
    "downloadUrl": "https://openagent3.xyz/downloads/mobula",
    "agentUrl": "https://openagent3.xyz/skills/mobula/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mobula/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mobula/agent.md"
  }
}