Market Depth Lab

Market Depth Lab MCP

AI エージェント向けの、Hyperliquid および取引所間の読み取り専用市場調査です。

🌐 プロジェクトのウェブサイトとライブダッシュボード：marketdepthlab.com

MCP の各結果は、公開ダッシュボード、手法、関連調査を掲載している Market Depth Lab にリンクしています。

Market Depth Lab MCP は、Claude、Codex、Cursor などの MCP クライアントに、Hyperliquid および取引所間の公開市場データを扱う 9 つの構造化ツールを提供します。秘密鍵、ウォレット署名、取引所へのログイン、取引の許可を求めることはありません。

独立したオープンソースソフトウェアです。Hyperliquid との提携や、同社による推奨を受けていません。調査情報のみを提供するものであり、投資助言ではありません。

このサーバーを利用する理由

• 最初の呼び出しから役立ちます： HYPE、資金調達率、ウォレット、TWAP、取引所間スプレッドをリアルタイムで照会できます。
• 設計上、読み取り専用です： 注文の発注、署名、ウォレットの変更は行いません。
• カバレッジを正直に示します： モニタリング対象アドレスのランキングは、プロトコル全体の保有者調査ではなく、対象コホートとして明示します。
• エージェントに適した出力： 各ツールは簡潔なテキストと安定した structuredContent を返します。
• 追跡可能です： 結果には、データソース、時刻／カバレッジの境界、および対応する Market Depth Lab ツールへの状態を保持するリンクが含まれます。

ツール

ツール	回答する内容
list_active_hyperliquid_twaps	どの公開 TWAP スケジュールが有効で、現在の推定想定元本はいくらですか？
analyze_hyperliquid_wallet	この公開アドレスについて、どのようなポジション、残高、注文、レバレッジ、PnL が確認できますか？
calculate_hyperliquid_fees	この想定元本、取引者の役割、手数料ティアでは、手数料はいくらと推定されますか？
get_hype_market_snapshot	現在の HYPE の価値はいくらで、現物と無期限先物を比べるとどうなりますか？
hyperliquid_summarize_large_trader_positions	モニタリング対象の大口取引者コホートは、市場ごとにどのようなポジションを取っていますか？
hyperliquid_list_top_position_holders	ある市場で最大のポジションを持つ、モニタリング対象アドレスはどれですか？
hyperliquid_list_funding_rates	現在、誰が資金調達料を支払っており、返された市場の過去 24 時間の合計は正確にいくらですか？
scan_cross_exchange_funding_spreads	ユーザー指定のコスト推定を適用した後、Binance USD-M、OKX、Hyperliquid 間で正規化後の資金調達率の差が最も大きいのはどこですか？
scan_cross_exchange_perp_price_spreads	手数料の推定と、板の最良気配値の可視流動性チェックを適用した後、各取引所の無期限先物の現在の最良買気配と最良売気配にはどの程度の差がありますか？

資金調達率とスプレッドのエンジン

以下の 3 つの概念は、意図的に別々に扱っています。

1. hyperliquid_list_funding_rates は、Hyperliquid のメイン市場と HIP-3 の資金調達率の全体を説明し、返されたページについて過去 24 時間の正確な合計を示します。
2. scan_cross_exchange_funding_spreads は、1 時間および 8 時間の決済間隔を正規化し、資金調達率の低い側をロング、高い側をショートにした場合を比較します。年率換算値は比較用であり、予測ではありません。
3. scan_cross_exchange_perp_price_spreads は、公開されている板の最良気配値を比較します。エントリー手数料と往復手数料の両方の見方に加え、選択された買気配／売気配レベルにおける、より小さい方の可視想定元本も報告します。想定元本の計算前に、OKX のコントラクト数は公開インストゥルメントの ctVal を使用して換算します。

このスキャナーは、Market Depth Lab のローカル調査で使用している読み取り専用モニタリングのワークフローを参考に、独自に TypeScript で実装したものです。参照用の Python プロジェクトを同梱したり、改変したりしていません。

いずれのスキャナーも注文を発注しません。表示される行はスクリーニング候補であり、執行可能な裁定取引やリスクのない裁定取引を証明するものではありません。資金調達率は変動する可能性があり、REST スナップショットは同時点のものではありません。通常、Binance／OKX は USDT、Hyperliquid のメイン市場の無期限先物は USDC で決済されます。また、より深い板でのスリッページ、送金、証拠金、清算、取引所へのアクセス、ポジション解消時の価格は推定の対象外です。

必要条件

• Node.js 20 以降
• Hyperliquid／HypurrScan の公開データにアクセスするためのインターネット接続
• API キー不要

npm でインストール

公開パッケージは market-depth-lab-mcp-serverです。

ローカルの stdio サーバーに対応した MCP クライアントで、次の設定を使用してください。

{
  "mcpServers": {
    "market-depth-lab": {
      "command": "npx",
      "args": ["-y", "market-depth-lab-mcp-server"]
    }
  }
}

npx は公開パッケージをダウンロードし、ローカルの読み取り専用 MCP プロセスを起動します。取引所へのログイン、ウォレット接続、API キーは不要です。

ソースからインストール

git clone https://github.com/derkcc/market-depth-lab-mcp.git
cd market-depth-lab-mcp
npm ci
npm run build

MCP クライアントでは、dist/index.js の絶対パスを使用してください。

{
  "mcpServers": {
    "market-depth-lab": {
      "command": "node",
      "args": ["/absolute/path/to/market-depth-lab-mcp/dist/index.js"]
    }
  }
}

実装を確認または変更する場合はソースをチェックアウトして使用してください。最短のインストール手順を使う場合は、上記の npm 設定を使用してください。

プロンプトの例

Show the five Hyperliquid markets with the highest absolute current funding.
Include trailing 24h funding and explain who pays whom.

Compare BTC, ETH, SOL and HYPE funding on Binance, OKX and Hyperliquid.
Assume a 24-hour holding period and 12 bps of total round-trip costs. Show
the current annualized spread, projected net carry and break-even hours.

Scan BTC, ETH and SOL perpetual top-of-book spreads across Binance, OKX and
Hyperliquid. Use round-trip taker fees, require at least $5,000 visible at
the selected levels, and explain every non-execution boundary.

Analyze 0x... on Hyperliquid. Summarize gross exposure, effective leverage,
largest position and recent realized PnL. Do not give trading advice.

Within the monitored cohort, list the top BTC positions and separate longs
from shorts. State the cohort boundary before the ranking.

Estimate round-trip taker fees for a $25,000 tier-zero perpetual position.

データとプライバシー

機能	データ経路
HYPE、ウォレット、Hyperliquid のファンディング	ローカルの MCP プロセス → 公開 Hyperliquid info API
取引所間のファンディングスプレッド	ローカルの MCP プロセス → 公開 Binance USD-M、OKX、Hyperliquid の市場データ API
取引所間の価格スプレッド	ローカルの MCP プロセス → 公開 Binance USD-M と OKX の book-ticker API、および Hyperliquid l2Book
アクティブな TWAP	ローカルの MCP プロセス → 公開 HypurrScan エンドポイント、および Hyperliquid の価格参照
大口ポジションと上位保有者	ローカルの MCP プロセス → Market Depth Lab のローリング方式の読み取り専用ポジションインデックス
手数料計算ツール	ローカルで実行。ネットワークリクエストなし

サーバーには分析機能やテレメトリーはありません。analyze_hyperliquid_wallet に送信されたウォレットアドレスは、お使いのマシンから公開 Hyperliquid API に直接送信されます。ポジションインデックスの呼び出しでは https://data.marketdepthlab.com/v1/positions/latest を使用します。

公開取引所のエンドポイントは、一部の地域で利用できない場合があります。どちらの取引所間ツールも、取引所ごとに available、partial、unavailable のカバレッジとエラーメッセージを示します。2 つまたは 3 つの取引所間の比較が完了したと、黙って主張することはありません。

ポジションインデックスの制約

Market Depth Lab は、監視対象の公開アドレスプールをローテーションします。このインデックスは、コホートレベルの市場構造を把握するのに役立ちますが、次のものではありません。

• Hyperliquid の全アカウントの一覧ではありません。
• 監視対象のすべてのアドレスを同時に取得したスナップショットではありません。
• アドレスの管理者を特定する証拠ではありません。
• いずれかのアドレスをコピーする推奨ではありません。

すべてのポジションツールは、スナップショットの時刻、経過時間、監視対象アドレス数、鮮度の状態、カバレッジの制約を報告します。

設定

すべての変数は省略可能です。

変数	デフォルト	用途
MDL_POSITION_INDEX_URL	https://data.marketdepthlab.com/v1/positions/latest	リモートの読み取り専用ポジションインデックス
MDL_POSITION_INDEX_PATH	未設定	リモートインデックスの代わりにローカルの JSON スナップショットを読み込む
MDL_MAX_SNAPSHOT_AGE_HOURS	24	この経過時間を過ぎたポジションスナップショットを古いものとして扱う
MDL_REJECT_STALE	false	古いデータであることを明示して返す代わりに、エラーを返す
MDL_HTTP_TIMEOUT_MS	15000	リクエストごとのネットワークタイムアウト

MDL_POSITION_INDEX_PATH が設定されている場合、2 つのポジションツールはネットワークリクエストを行いません。その他のライブデータツールは引き続き公開アップストリーム API を使用します。

開発

npm ci
npm run check
npm test
npm pack --dry-run

テストスイートは、メモリ内で MCP ハンドシェイクを実行し、9 つのツール定義を検証して、プロトコル経由でローカルの手数料計算ツールを呼び出します。リリース前にはライブアップストリームのスモークテストを実行してください。ただし、決定論的な CI からは意図的に除外されています。

プロジェクトの公開リンク

• ウェブサイト：https://marketdepthlab.com
• ライブツール：https://marketdepthlab.com
• イシュー：GitHub Issues
• セキュリティ：SECURITY.md
• コントリビューション：CONTRIBUTING.md

ライセンス

MIT