Hydromancer

Hydromancer MCP

Hydromancer APIのライブデータを使って、平易な英語でAIにHyperliquidについて質問できます。

開示： このパッケージはHydromancerチームが保守しています。利用にはHydromancer APIキーが必要です。

「このウォレットは何を保有していますか？　また、優れたトレーダーですか？」 「今週、ボットを除くと最も優れたトレーダーは誰ですか？」 「過去6時間に清算されたのは誰ですか？」 「価格を0.5％動かさずに、BTCをどれだけ売れますか？」

AIが適切なツールを選び、Hydromancerを呼び出して回答を説明します。APIドキュメントを読んだり、コードを書いたり、タイムスタンプを調べたりする必要はありません。

• 読み取り専用ツールが19個：ウォレット、取引、上位トレーダー、マーケット、清算、ビルダー、予測マーケット
• あらゆるMCPアプリで動作：Claude Desktop、Claude Code、Cursor、Codex、VS Code（Copilot）、Gemini CLI、Windsurf、Clineなど
• わかりやすい入力：大文字・小文字を問わないコイン名（btc、$ETH、ETH-PERP、xyz:tsla）、24h、7d、2026-10-01のような時刻
• 安全：読み取り専用です。注文の発注、キャンセル、署名はできず、資金や秘密鍵に触れることもありません
• キーはローカルに保持：アプリの設定から読み込まれ、api.hydromancer.xyz（または設定した場合はapi-testnet.hydromancer.xyz）以外に送信されることはありません

1. Hydromancer APIキーを取得する

APIキーを取得するをご覧ください。初期段階のチームは無料で利用できる場合があります。

2. AIアプリに追加する

Node.js 20以降が必要です。YOUR_KEYを自分のキーに置き換えてください。

Claude Desktop

設定 → 開発者 → 設定を編集し、次を追加します。

{
  "mcpServers": {
    "hydromancer": {
      "command": "npx",
      "args": ["-y", "hydromancer-mcp"],
      "env": { "HYDROMANCER_API_KEY": "YOUR_KEY" }
    }
  }
}

Claude Desktopを再起動します。

Claude Code

claude mcp add hydromancer -e HYDROMANCER_API_KEY=YOUR_KEY -- npx -y hydromancer-mcp

Cursor

~/.cursor/mcp.json（すべてのプロジェクト）または.cursor/mcp.json（1つのプロジェクト）に、Claude Desktopと同じmcpServersブロックを使用します。

Codex

~/.codex/config.toml：

[mcp_servers.hydromancer]
command = "npx"
args = ["-y", "hydromancer-mcp"]
env = { HYDROMANCER_API_KEY = "YOUR_KEY" }

VS Code（GitHub Copilot）

.vscode/mcp.json：

{
  "servers": {
    "hydromancer": {
      "command": "npx",
      "args": ["-y", "hydromancer-mcp"],
      "env": { "HYDROMANCER_API_KEY": "YOUR_KEY" }
    }
  }
}

ローカルコピーから実行する

git clone https://github.com/joshavenue/Hydromancer-MCP && cd Hydromancer-MCP
npm install && npm run build

次に、"command": "node"と"args": ["/full/path/to/Hydromancer-MCP/dist/index.js"]を使用します。

3. 質問する

次の例をお試しください。

• Give me an overview of wallet 0x… and tell me if it's a good trader.
• Show the top 10 traders by profit over the last 7 days, no bots, then what the top 3 hold right now.
• Which of these wallets have more than $1M: 0x…, 0x…, 0x…?
• Who got liquidated on Hyperliquid in the last 6 hours? Longs or shorts?
• BTC, ETH and HYPE: price, 24h volume and open interest.
• Has ETH open interest been rising or falling today?
• What's the BTC funding rate averaged over the last week, annualized?
• How much did builder 0x… earn in fees in the last hour?

ツール

ツール	わかること
hydromancer_wallet_overview	残高（統合アカウントおよびポートフォリオ・マージンのウォレットでは正確な値）、アカウントモード、未決済ポジション（エントリー価格、清算価格、レバレッジ、損益）、現物残高、取引履歴、ボットスコア
hydromancer_compare_wallets	最大1,000件のウォレットを一度に比較。残高とアカウントモードを表示し、残高順に並べ替え
hydromancer_wallet_trades	指定した期間の約定。取引高、損益、手数料、コイン別合計を表示
hydromancer_wallet_closed_trades	往復取引：勝率、純損益、保有時間、最も成績の良いコイン
hydromancer_wallet_open_orders	未約定の指値注文、ストップロス、テイクプロフィット
hydromancer_wallet_transfers	入金、出金、送金、ボールトへの移動、清算
hydromancer_wallet_funding	コイン別の支払いまたは受け取り済みファンディング
hydromancer_top_traders	利益、勝率、取引高によるランキング。ボットとアクティビティのフィルター付き
hydromancer_market_snapshot	価格、24時間取引高、未決済建玉（主要マーケット一覧では最大レバレッジも表示）
hydromancer_price_history	1秒から1か月までのローソク足（15秒および30秒も含む）
hydromancer_funding_history	ファンディングレート、平均値、年率換算値
hydromancer_open_interest_history	1分から1か月までの間隔で表示する未決済建玉の推移
hydromancer_recent_liquidations	マーケット別の清算。ロングとショートの合計を表示
hydromancer_market_depth	注文板の厚さと、指定した取引サイズでのスリッページ
hydromancer_list_markets	すべてのマーケット、HIP-3 取引所、名前またはカテゴリーでの検索
hydromancer_builder_activity	ビルダーアプリの取引高、ユーザー数、手数料
hydromancer_prediction_markets	決済済みの HIP-4 予測マーケット
hydromancer_my_usage	ご自身の API 使用状況とトークン数
hydromancer_raw_request	その他すべての Hydromancer /info リクエスト

サーバーは、質問に応じてどのツールを使うべきか AI に伝える hydromancer_guide プロンプトと hydromancer://guide リソースも提供します。

設定

変数	デフォルト	用途
HYDROMANCER_API_KEY	（必須）	API キー
HYDROMANCER_BASE_URL	https://api.hydromancer.xyz/info	API エンドポイント。使用できるのは Hydromancer のメインネットおよびテストネットのホストのみです。
HYDROMANCER_TIMEOUT_MS	30000	リクエストのタイムアウト
HYDROMANCER_MAX_RESULT_CHARS	40000	AI に過剰なデータを渡さないよう、1つのツール結果の文字数を制限します

知っておくとよいこと

• API リクエストと同様に、各ツール呼び出しで Hydromancer プランのトークンを使用します。使用状況は hydromancer_my_usage で確認できます。
• メインネットのみです。HIP-3 マーケットでは、たとえば xyz:TSLA のようにプレフィックスを使用します。
• 残高：統合アカウントおよびポートフォリオ・マージンのウォレットは現物口座に資金を保有するため、balanceUsd は現物のステーブルコインを使って算出されます。その他の現物トークンは表示されますが、価格は算出されません。
• 時刻は UTC です。一部のエンドポイントでは1回のリクエストに上限があります（例：2,000件の約定）。上限に達した場合はツールが通知します。

開発

npm install
npm run build
npm test                                   # offline unit tests
HYDROMANCER_API_KEY=... npm run smoke      # calls every tool against the live API

Hydromancer ブログの記事

Hyperliquid のデータの取得方法と活用方法に関するガイドと調査記事です。

• Reservoir の Hyperliquid データをクエリする方法
• Hyperliquid API と Hydromancer API：アップグレードするタイミングは？
• Hyperliquid でトレーダーのポジションをすべて表示する方法
• Hyperliquid ノードの信頼できるピアを見つける方法
• Hyperliquid Builder Codes：仕組みと手数料の追跡方法
• Hyperliquid テストネットガイド：フォーセット、API URL、メインネットでの注意点
• Hyperliquid の手数料と収益：ビルダー向けガイド
• HyperCore と HyperEVM：Hyperliquid は L1 か L2 か？
• Hyperliquid のティックサイズとロットサイズ：価格と数量の丸め方
• Hyperliquid のオーダーブック・ヒートマップの作り方
• Hyperliquid Vaults API：パフォーマンスと預金者を追跡する
• Hyperliquid ウォレットの取引履歴を取得する方法（API ＋ バルク）
• Hyperliquid のファンディングレート：仕組みと履歴
• Hyperliquid のコピートレードボットの作り方
• Hyperliquid のトレーディングボットの作り方
• Hyperliquid リーダーボード：トップアドレスの PnL を追跡する方法
• Hydromancer のライブ統計ページの読み方
• Hyperliquid のレート制限：その内容と解決策
• HIP-3 市場のデプロイヤーを数値で比較
• Hyperliquid API ガイド：エンドポイント、API キー、制限、Python の例
• Hyperliquid のトッププロップファーム：徹底比較
• Hyperliquid の清算データを活用した開発方法
• Hyperliquid のクジラ追跡ツールの作り方（リアルタイムのポジション、約定、アラート）

ライセンス

MIT