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"

戻り値:

• 現在の価格（USD）
• 価格変動: 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チェーンにわたる完全なポートフォリオを1回の呼び出しで取得します。

パラメータ:

• wallet (必須): ウォレットアドレス
  • 形式: "0x..." または ENS名（例: "vitalik.eth"）
• blockchains (オプション): 特定のチェーンにフィルタリングするカンマ区切りリスト
  • デフォルト: 全チェーン
• cache (オプション): キャッシュデータを使用（高速、やや鮮度低下）

戻り値:

• 保有する全トークン:
  • トークン名、シンボル、アドレス
  • 残高（数量とUSD価値）
  • 現在の価格
  • 24時間の価格変動
  • 推定損益
  • チェーン
• ポートフォリオ合計価値（USD）
• トークン別ポートフォリオ配分（パーセンテージ）
• 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"
  • デフォルト: 時間枠に基づき自動選択

戻り値:

• タイムスタンプ付き価格ポイントの配列
• 各ポイントの出来高
• 各ポイントの時価総額

使用例:

• "過去30日間のETH価格を見せて"
• "このトークンの1月1日の価格は？"
• "今週このトークンはポンプしてる？それともダンプ？"
• "過去7日間のBTCの価格推移をチャートで"

使用すべき場合:

• トレンド分析
• 過去の損益計算
• 時間枠間の価格アクション比較
• パターン認識（ブレイクアウト、サポート、レジスタンス）

---

4. 最近の取引 (mobula_market_trades)

エンドポイント: GET https://api.mobula.io/api/1/market/trades

すべてのDEXおよびチェーンにわたる任意のトークンのライブ取引フィード。

パラメータ:

• asset (必須): トークン名、シンボル、またはアドレス
• limit (オプション): 返す取引数（デフォルト: 50、最大: 300）

戻り値:

• 最近の取引の配列:
  • タイムスタンプ
  • タイプ（買い/売り）
  • 数量（トークン数とUSD価値）
  • 取引時価格
  • ウォレットアドレス（買い手/売り手）
  • DEXとチェーン
  • トランザクションハッシュ

使用例:

• "このトークンの最近の取引を見せて"
• "今誰がPEPEを買ってる？"
• "このトークンでクジラの動きはある？"
• "このトークンの最後の10件の取引は？"

使用すべき場合:

• クジラ監視
• 異常な活動の検出（大口買い/売り）
• 出来高の検証
• センチメント分析（買い vs 売りの比率）

---

5. ウォレット取引履歴 (mobula_wallet_transactions)

エンドポイント: GET https://api.mobula.io/api/1/wallet/transactions

任意のウォレットの全チェーンにわたる完全な取引履歴。

パラメータ:

• wallet (必須): ウォレットアドレス
• from (オプション): 開始タイムスタンプ
• to (オプション): 終了タイムスタンプ
• asset (オプション): 特定のトークンでフィルタリング
• limit (オプション): 取引数（デフォルト: 100）

戻り値:

• 取引の配列:
  • タイプ（スワップ、転送、ミント、バーン）
  • 関連トークン（from/to）
  • 数量
  • 取引時のUSD価値
  • タイムスタンプ
  • チェーン
  • トランザクションハッシュ

使用例:

• "このウォレットは最近何を買った？"
• "0x123...の最後の10件の取引を見せて"
• "このウォレットが最後にETHを売ったのはいつ？"
• "このクジラの活動を追跡"

使用すべき場合:

• ウォレット監視
• クジラ追跡
• パターン検出（何を売買しているか）
• 取引検証

---

6. 複数アセットデータ (mobula_market_multi)

エンドポイント: GET https://api.mobula.io/api/1/market/multi-data

一度のリクエストで複数トークンの市場データを取得（バッチエンドポイント）。

パラメータ:

• assets (必須): カンマ区切りのトークン名/シンボル/アドレスリスト
  • 例: "Bitcoin,Ethereum,Solana" または "BTC,ETH,SOL"
  • 最大: 1リクエストあたり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="your_key_here"
   

3. OpenClawエージェントを再起動

ヘッダー形式:

Authorization: ${MOBULA_API_KEY}

認証失敗時（401/403）:

• キーが設定されているか確認: echo $MOBULA_API_KEY
• キーが期限切れの場合は https://mobula.io で再生成
• レート制限を確認（無料: 100 req/min、アップグレードで増加）

---

プライバシーとセキュリティ

重要 - 使用前に必ず読んでください:

このスキルがアクセスするもの

• 公開ブロックチェーンデータのみ: ウォレットアドレス、トークン価格、取引履歴
• 秘密鍵なし: 秘密鍵、シードフレーズ、パスワードをこのスキルに絶対に提供しないでください
• 機密情報なし: スキルに必要なのは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. 新たな大口取引（>5万ドル）があった場合:
   • 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%上昇

ファンダメンタル:
- 時価総額: 210万ドル（小型株、高リスク/リターン）
- 流動性: 28万ドル（規模の割には良好）
- 出来高: 24時間で120万ドル（健全）

オンチェーン:
- 最近の取引では買い圧力（買い/売り比率3:1）
- 過去2時間に大口買い2件（5万ドル以上）

プロジェクト:
- コントラクト検証済み
- 活発なTwitter（12,000フォロワー）

リスク: 小型株、高ボラティリティ。失っても構わない以上は賭けないこと。

---

応答フォーマットガイドライン

価格

• 常に方向性を示す: 「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 で新しいキーを生成し、再設定してください。」

レート制限

• 「APIリクエスト制限に達しました。1分後に再試行するか、https://mobula.io でプランをアップグレードしてください。」

データ利用不可

• サポートされていないトークン: 「このトークンはMobulaで利用できません。名前、シンボル、またはアドレスが正しいことを確認してください。」
• 無効なウォレット: 「無効なウォレットアドレスです。'0x...' 形式かENS名であることを確認してください。」
• タイムアウト: 「データの取得に時間がかかっています。しばらくしてからもう一度お試しください。」

---

制限事項

データ範囲

• プライベートチェーンやサイドチェーンを含む88以上のブロックチェーンをカバー
• サポート外: オフチェーンデータ、集中管理取引所の残高、トレンド分析
• データはMobulaによって1〜60秒ごとに更新

レート制限

• 無料枠: 100リクエスト/分
• アップグレードでより高い制限
• バッチエンドポイントは1リクエストとしてカウント

価格の正確性

• オラクル級価格（Chainlink、Supra、API3が信頼）
• 複数のDEXと流動性ソースから集約
• 価格は流動性が低いトークンでは数セントから数ドル変動する可能性あり

---

設定例

クイックスタート

1. APIキーを取得:

   • https://mobula.io にアクセス
   • 無料アカウントにサインアップ
   • APIキーを生成

2. 環境変数を設定:

   export MOBULA_API_KEY="mobula_xxx..."
   

3. 動作確認:

   • "ビットコインの価格は？"
   • "vitalik.ethのポートフォリオを見せて"

上級者向け設定

以下を含む .env ファイルを作成:

MOBULA_API_KEY=mobula_xxx...

すべての機能が動作することをテスト:

• 単一トークンの市場データ
• ウォレットポートフォリオ
• 利用可能な場合の履歴データ

---

高度な使用例

クロスチェーンディールファインダー

1. ユーザーのウォレットから保有資産を取得: mobula_wallet_portfolio
2. 保有資産ごとに初期購入価格を取得（取引履歴から）
3. 現在の価格と比較: mobula_market_data
4. 含み益の大きいトークンを特定（利益確定の候補）
5. 含み損の大きいトークンを特定（ドルコスト平均法の候補）

センチメントクロスチェック

1. トークンの価格アクションをチェック: mobula_market_data
2. 取引アクティビティを確認: mobula_market_trades
3. センチメントを計算:
   • 買い圧力（買い/売り比率 > 1.5 = 強気）
   • 出来高スパイク（24時間平均の3倍以上）
   • クジラの動き（大口取引）

自動リバランス提案

トリガー: ポートフォリオ配分が設定したしきい値から乖離 アクション:

1. 現在の配分を取得: mobula_wallet_portfolio
2. 目標配分と比較
3. 取引の提案を生成（買うもの、売るもの、数量）
4. ユーザーに裁量を委ねる