Mobula - 多鏈加密數據智能

Mobula - 多鏈加密數據智能 是做什麼的？

即時加密貨幣市場數據、錢包追蹤與鏈上分析，橫跨 88+ 條區塊鏈。受 Chainlink、Supra 和 API3 信賴的預言機級定價。

何時使用此技能

使用時機：當使用者：

• 詢問任何代幣的價格、交易量、市值或價格變動
• 想查看錢包的持倉或投資組合價值
• 需要圖表或分析的歷史價格數據
• 提到合約地址並想要代幣資訊
• 詢問特定鏈上的代幣（Base、Arbitrum、Solana 等）
• 想要跨鏈投資組合概覽
• 需要一次取得多個代幣的批量數據
• 詢問代幣的流動性、ATH、ATL 或交易量
• 想追蹤鯨魚錢包或監控重大交易
• 想尋找符合特定條件的新代幣

不應使用時機：

• 使用者想執行交易（應使用 bankr 技能）
• 使用者想取得 DEX 兌換報價（應使用 defi 技能）
• 使用者想取得交易所特定數據（應使用 okx/binance 技能）

---

核心功能

1. 市場數據 (mobula_market_data)

端點： GET https://api.mobula.io/api/1/market/data

取得任何代幣在所有支援鏈上的即時價格、交易量、市值和流動性。

參數：

• asset（必填）：代幣名稱、代號或合約地址
  • 範例："Bitcoin"、"ETH"、"0x532f27101965dd16442e59d40670faf5ebb142e4"
• blockchain（選填）：要查詢的特定鏈
  • 範例："base"、"arbitrum"、"ethereum"、"solana"、"polygon"

回傳內容：

• 目前價格（美元）
• 價格變動：1小時、24小時、7天、30天（百分比與絕對值）
• 交易量（24小時）
• 市值
• 完全稀釋估值
• 流動性
• 歷史最高價 (ATH) 與歷史最低價 (ATL)，附日期
• 總供應量、流通供應量

使用範例：

• "比特幣的價格是多少？"
• "在 Base 鏈上查詢 BRETT 的市場數據"
• "取得合約地址 0x532f27101965dd16442e59d40670faf5ebb142e4 的數據"
• "ETH 現在是在漲還是跌？"
• "PEPE 的市值是多少？"

使用時機：

• 使用者詢問任何代幣的價格
• 使用者想知道某項目是否在暴漲/暴跌
• 分析代幣基本面（市值、流動性、交易量）
• 比較代幣
• 設定價格警報

---

2. 錢包投資組合 (mobula_wallet_portfolio)

端點： GET https://api.mobula.io/api/1/wallet/portfolio

透過單一呼叫取得橫跨 88 條鏈的任何錢包的完整投資組合。

參數：

• wallet（必填）：錢包地址
  • 格式："0x..." 或 ENS 名稱（例如 "vitalik.eth"）
• blockchains（選填）：以逗號分隔的列表，用於篩選特定鏈
  • 預設：所有鏈
• cache（選填）：使用快取數據（速度更快，即時性稍低）

回傳內容：

• 持有的所有代幣，包含：
  • 代幣名稱、代號、地址
  • 餘額（數量和美元價值）
  • 目前價格
  • 24小時價格變動
  • 估計損益
  • 所屬鏈
• 投資組合總價值（美元）
• 按代幣劃分的投資組合配置（百分比）
• NFT（如果有）

使用範例：

• "顯示錢包 0x123... 的投資組合"
• "vitalik.eth 持有哪些代幣？"
• "查詢我的錢包餘額"
• "這個錢包的總價值是多少？"
• "顯示這個錢包的前 5 大持倉"

使用時機：

• 投資組合追蹤
• 錢包分析
• 交易前/後檢查持倉
• 監控資產配置
• 設定投資組合警報

---

3. 歷史價格數據 (mobula_market_history)

端點： GET https://api.mobula.io/api/1/market/history

取得任何代幣在靈活時間範圍內的歷史價格數據。

參數：

• asset（必填）：代幣名稱、代號或地址
• from（選填）：開始時間戳記（Unix 秒數）
• to（選填）：結束時間戳記（Unix 秒數）
• period（選填）：數據粒度
  • 選項："1h"、"1d"、"1w"
  • 預設：根據時間範圍自動選擇

回傳內容：

• 包含時間戳記的價格點陣列
• 每個點的成交量
• 每個點的市值

使用範例：

• "顯示 ETH 過去 30 天的價格"
• "這個代幣在 1 月 1 日的價格是多少？"
• "這個代幣本週是在暴漲還是暴跌？"
• "繪製 BTC 過去 7 天的價格走勢圖"

使用時機：

• 分析趨勢
• 計算歷史損益
• 比較不同時間範圍的價格走勢
• 識別模式（突破、支撐、阻力）

---

4. 近期交易 (mobula_market_trades)

端點： GET https://api.mobula.io/api/1/market/trades

任何代幣在所有 DEX 和鏈上的即時交易饋送。

參數：

• asset（必填）：代幣名稱、代號或地址
• limit（選填）：要回傳的交易筆數（預設：50，最大：300）

回傳內容：

• 近期交易的陣列，包含：
  • 時間戳記
  • 類型（買/賣）
  • 數量（代幣與美元）
  • 交易價格
  • 錢包地址（買方/賣方）
  • 去中心化交易所(DEX) 與區塊鏈
  • 交易哈希

使用範例：

• "顯示這個代幣的近期交易"
• "誰在買入 PEPE？"
• "這個代幣有鯨魚在移動嗎？"
• "這個代幣最近 10 筆交易是什麼？"

使用時機：

• 鯨魚觀察
• 偵測異常活動（大量買入/賣出）
• 成交量驗證
• 情緒分析（買入多於賣出）

---

5. 錢包交易歷史 (mobula_wallet_transactions)

端點： GET https://api.mobula.io/api/1/wallet/transactions

任何錢包在所有鏈上的完整交易歷史。

參數：

• wallet（必填）：錢包地址
• from（選填）：開始時間戳記
• to（選填）：結束時間戳記
• asset（選填）：按特定代幣篩選
• limit（選填）：交易筆數（預設：100）

回傳內容：

• 交易陣列：
  • 類型（swap、transfer、mint、burn）
  • 涉及的代幣（來源/目標）
  • 數量
  • 交易時的美元價值
  • 時間戳記
  • 區塊鏈
  • 交易哈希

使用範例：

• "這個錢包最近買了什麼？"
• "顯示 0x123... 錢包的最後 10 筆交易"
• "這個錢包最後一次賣出 ETH 是什麼時候？"
• "追蹤這個鯨魚的活動"

使用時機：

• 錢包監控
• 鯨魚追蹤
• 模式偵測（他們買/賣什麼）
• 交易驗證

---

6. 多資產數據 (mobula_market_multi)

端點： GET https://api.mobula.io/api/1/market/multi-data

在單一請求中取得多個代幣的市場數據（批量端點）。

參數：

• assets（必填）：以逗號分隔的代幣名稱/代號/地址列表
  • 範例："Bitcoin,Ethereum,Solana" 或 "BTC,ETH,SOL"
  • 最多：每次請求 500 個代幣

回傳內容：

• 與 mobula_market_data 相同，但針對多個代幣
• 對於投資組合分析、觀察清單、市場概覽非常高效

使用範例：

• "比較 BTC、ETH 和 SOL 今天的表現"
• "顯示我觀察清單中漲跌最大的代幣"
• "取得這 10 個代幣的價格：[列表]"

使用時機：

• 投資組合估值
• 監控列表更新
• 市場概覽（主流幣種）
• 批量價格查詢

---

7. 代幣元數據 (mobula_metadata)

端點： GET https://api.mobula.io/api/1/metadata

取得任何代幣的詳細元數據。

參數：

• asset（必填）：代幣名稱、代號或地址

回傳內容：

• 名稱、代號、標誌
• 描述
• 網站、Twitter、Telegram、Discord 連結
• 所有鏈上的合約地址
• 上線日期
• 分類/標籤

使用範例：

• "告訴我關於這個代幣的資訊"
• "這個項目的網站是什麼？"
• "在哪裡可以找到他們的社群？"

使用時機：

• 研究新代幣
• 驗證合法性
• 尋找官方連結

---

認證

必要： 所有 API 請求都需要透過 API 金鑰進行認證。

設定方式：

1. 在 https://mobula.io 取得免費 API 金鑰（免費方案每分鐘 100 次請求）
2. 設定環境變數：

   export MOBULA_API_KEY="你的金鑰_在這裡"
   

3. 重新啟動 OpenClaw 代理

標頭格式：

Authorization: ${MOBULA_API_KEY}

如果認證失敗（401/403）：

• 確認金鑰是否已設定：echo $MOBULA_API_KEY
• 如果金鑰已過期，請前往 https://mobula.io 重新產生
• 檢查速率限制（免費方案每分鐘 100 次請求，可升級以獲得更多額度）

---

隱私與安全性

重要 - 使用前請閱讀：

此技能存取的資料

• 僅限公開區塊鏈數據：錢包地址、代幣價格、交易歷史
• 無私鑰：切勿向此技能提供私鑰、助記詞或密碼
• 無敏感憑證：技能僅需 Mobula API 金鑰（公開數據存取）

錢包地址隱私

• 透過此技能查詢的錢包地址會發送到 Mobula 的 API (https://api.mobula.io)
• 查詢錢包地址會公開其持倉（鏈上數據本為公開）
• 僅使用您願意分享的公開錢包地址
• 切勿輸入您希望保密或與您身份相關聯的地址

API 金鑰範圍

• Mobula API 金鑰僅提供對公開區塊鏈數據的唯讀存取
• 可在 https://mobula.io 設定範圍、輪換和撤銷金鑰
• 免費方案：每分鐘 100 次請求
• 考慮為測試和生產環境使用不同的 API 金鑰

數據保留

• Mobula 可能會記錄 API 請求用於分析和速率限制
• 請參閱 Mobula 的隱私政策：https://mobula.io/privacy
• 請勿查詢您認為敏感的錢包或數據

最佳實踐

1. 使用一次性/測試 API 金鑰進行初始測試
2. 僅查詢公開錢包地址（例如 vitalik.eth、知名地址）
3. 如果您希望保護隱私，請避免查詢個人錢包
4. 定期輪換 API 金鑰
5. 在 https://mobula.io 監控速率限制和使用情況

---

使用心跳機制的智慧監控模式

OpenClaw 的心跳系統每約 30 分鐘檢查一次條件。可用於主動監控。

模式 1：投資組合守護

每次心跳：

1. 透過 mobula_wallet_portfolio 取得使用者的錢包
2. 計算配置百分比
3. 檢查條件：
   • 任何代幣占投資組合超過 40% → 建議重新平衡
   • 任何代幣 24 小時內下跌超過 15% → 發出警報並附上背景資訊
   • 投資組合總價值變動超過 10% → 通知
4. 將先前的值儲存在記憶體中以偵測變動
5. 在使用者偏好的時間發送每日摘要

模式 2：鯨魚觀察

每次心跳：

1. 透過 mobula_wallet_transactions 檢查已追蹤錢包的交易
2. 如果有新的重大交易（超過 50,000 美元）：
   • 透過 mobula_market_data 取得代幣詳細資訊
   • 透過 mobula_market_trades 檢查近期交易
   • 交叉比對其他追蹤的鯨魚是否買入了相同代幣
3. 如果多頭鯨魚買入 → 優先警報

模式 3：代幣探勘（自主發現）

每 4-6 小時心跳檢查：

1. 使用者定義條件（儲存於記憶體）：
   • 區塊鏈：Base、Arbitrum
   • 市值：低於 500 萬美元
   • 流動性：高於 10 萬美元
   • 24 小時交易量變動：超過 +50%
2. 透過 mobula_market_data 查詢搜尋/篩選代幣
3. 對於每個匹配項：
   • 透過 mobula_market_history 取得 7 天歷史
   • 透過 mobula_metadata 檢查元數據
   • 計算風險評分
4. 發送前 3 名並附上分析

模式 4：智慧價格警報

建立情境式警報，而非簡單的"價格 > X"警報。

範例："如果比特幣在 1 小時內波動超過 5%，且交易量高於 24 小時平均的 2 倍，則提醒我"

每次心跳：

1. 透過 mobula_market_data 取得目前價格和交易量
2. 與 1 小時前的價格（儲存在記憶體中）進行比較
3. 檢查交易量條件是否滿足
4. 僅在兩個條件都為真時才發出警報

---

組合多個端點以獲得豐富見解

範例：完整代幣分析

使用者問："我應該買這個代幣嗎？"

1. mobula_market_data → 目前價格、市值、交易量、流動性
2. mobula_market_history → 7 天和 30 天趨勢
3. mobula_market_trades → 近期活動（累積還是分發？）
4. mobula_metadata → 專案資訊、社群、合約驗證

回覆格式：

TOKEN 分析

價格：$0.042（24 小時下跌 8%，7 天上漲 156%）
- 接近 7 日高點，從 $0.051 回落
- 仍比 30 日低點上漲 400%

基本面：
- 市值：$2.1M（小市值，高風險/報酬）
- 流動性：$280K（以規模而言尚可）
- 交易量：24 小時 $1.2M（健康）

鏈上：
- 近期交易顯示買盤壓力（買/賣比 3:1）
- 過去 2 小時內有 2 筆大額買入（$50K+）

專案：
- 合約已驗證
- Twitter 活躍（12K 粉絲）

風險：小市值，高波動性。不要投入超過你能承受損失的金額。

---

回覆格式指南

價格

• 始終顯示方向："上漲 12.4%" 或 "下跌 3.2%"
• 包含時間範圍："上漲 12.4%（24 小時）"
• 提供背景資訊："價格 $0.042（24 小時上漲 12%，自 ATH 下跌 8%）"

大數字

• 格式清晰："$1.23M"、"$456K"、"$45.6B"
• 不使用："$1234567"

百分比

• 用於配置比例："ETH：占投資組合 42%"
• 用於變動："24 小時內下跌 15.3%"

背景資訊是關鍵

不要只說"價格是 $0.003" 要說："價格 $0.003（24 小時下跌 8%，較 12 月 1 日的 ATH $0.089 下跌 65%，但比 7 日低點上漲 12%）"

---

常見使用者請求及處理方式

"為 [代幣] 設定警報"

1. 確認請求
2. 詢問具體條件（價格門檻？百分比變動？交易量飆升？）
3. 確認您將透過心跳進行監控
4. 將警報配置儲存在記憶體中
5. 確認："我將每 30 分鐘檢查 [代幣]，如果 [條件] 成立，我會在 [頻道] 上提醒您"

"追蹤這個錢包"

1. 將錢包加入監控清單
2. 詢問要監控什麼：
   • 所有活動？
   • 僅大額交易（超過 $X）？
   • 特定代幣？
3. 儲存在記憶體中
4. 確認監控已啟用

"尋找符合 [條件] 的代幣"

1. 釐清條件：
   • 區塊鏈？
   • 市值範圍？
   • 交易量要求？
   • 最低流動性？
2. 設定定期檢查（建議 4-6 小時間隔）
3. 詢問需要多少結果
4. 在下一次心跳時開始監控

"現在加密貨幣市場發生什麼事？"

1. 透過 mobula_market_multi 檢查主要代幣（BTC、ETH、SOL、BNB）
2. 識別任何重大變動（24 小時內超過 5%）
3. 檢查交易量領頭羊
4. 提供簡潔的概覽

---

錯誤處理

API 金鑰問題

• 未設定金鑰： "我需要一個 Mobula API 金鑰來取得加密數據。請前往 https://mobula.io 免費取得，然後將其添加到您的環境中，指令為 export MOBULA_API_KEY='your_key'"
• 金鑰無效： "您的 API 金鑰似乎無效。請在 https://mobula.io 檢查並重新產生。"
• 速率限制： "已達到速率限制。免費方案每分鐘允許 100 次請求。請稍後再試或考慮升級您的方案。"

參數驗證

• 缺少必要參數： "請提供一個代幣名稱、代號或合約地址。"
• 無效錢包地址： "提供的錢包地址似乎無效。請檢查格式（應為 '0x...' 或 ENS 名稱）。"
• 不支援的區塊鏈： "不支援區塊鏈 '[名稱]'。支援的區塊鏈包括：ethereum、base、arbitrum、solana、polygon 等。"

數據可用性

• 未找到代幣： "在我們的資料庫中找不到 '[代幣]'。請檢查名稱、代號或合約地址是否正確。"
• 無交易： "此錢包/代幣沒有近期交易。"
• 無歷史記錄： "所請求時間範圍內沒有歷史數據。"

閘道逾時 (504)

• 重試端點
• 如果持續失敗，使用較短的時間範圍
• 如果問題仍然存在，通知使用者 Mobula 服務可能暫時中斷

---

關於 Mobula

Mobula 提供受 Chainlink、Supra 和 API3 等頂級預言機信賴的企業級加密數據基礎設施。我們的 API 為開發者打造，提供即時、可驗證的跨鏈數據。

主要功能：

• 覆蓋 88+ 條區塊鏈
• 100K+ 代幣
• 預言機級定價
• 即時更新
• 企業級可靠性

更多資訊：

• 網站：https://mobula.io
• 文件：https://docs.mobula.io