Mobula - Crypto Market Data & Wallet Intelligence

实时加密货币市场数据、钱包投资组合跟踪和代币 跨 88 个以上区块链的分析。当用户想要检查时使用 任何代币价格（按名称、符号或合约地址），查找钱包 所有链上的余额和持有量，获取历史价格数据， 跟踪投资组合盈亏、监控鲸鱼钱包、寻找新代币或获取 甲骨文级定价。需要 mobula.io 提供的免费 API 密钥。

## 概述（中文）

实时加密货币市场数据、钱包投资组合跟踪和代币
跨 88 个以上区块链的分析。当用户想要检查时使用
任何代币价格（按名称、符号或合约地址），查找钱包
所有链上的余额和持有量，获取历史价格数据，
跟踪投资组合盈亏、监控鲸鱼钱包、寻找新代币或获取
甲骨文级定价。需要 mobula.io 提供的免费 API 密钥。

## 原文

# 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:
   ```bash
   export MOBULA_API_KEY="your_key_here"
   ```
3. Restart OpenClaw agent

**Header format:**
```
Authorization: ${MOBULA_API_KEY}
```

**If a