Hyperliquid

@pipeworx/hyperliquid

Hyperliquid は最大のオンチェーン無期限先物取引所です（現物市場も運営しています）。ミッド価格、オーダーブック、ローソク足、資金調達率／履歴、リアルタイムの未決済建玉、任意のウォレットアドレスの公開アカウント状態（無期限先物の証拠金とポジション、現物残高、アカウント価値の履歴）を、リクエストごとに Hyperliquid 独自の公開情報 API からリアルタイムでプロキシします。キーも署名も取引も不要です。署名付きの取引所エンドポイントは意図的に対象外としています。

Pipeworx の一部です。AI エージェントを 1881 以上のリアルタイムデータソースにつなぐ MCP ゲートウェイです。独立した非公式の連携であり、上流プロバイダーとは提携、承認、公開のいずれもしていません。

ツール

• hyperliquid_perp_meta(coin?) — 無期限先物の銘柄一覧（シンボル、小数点以下の数量桁数、最大レバレッジ、上場廃止フラグ）。1 つのシンボルを指定する場合は coin を渡し、一覧全体を取得する場合は省略します。

• hyperliquid_spot_meta() — Hyperliquid が掲載する現物取引ペアすべてと、各ペアの名前、ペアインデックス、構成するトークン ID を返します。

• hyperliquid_mids(coin?) — 1 回の呼び出しで無期限先物／現物の全シンボルの現在のミッド価格を取得するか、1 つのシンボルのミッド価格だけを取得します。

• hyperliquid_asset_context(coin) — 無期限先物のリアルタイムの資金調達率、未決済建玉、マーク／オラクル／ミッド価格、プレミアム、24 時間の取引量を返します。

• hyperliquid_l2_book(coin, depth?) — リアルタイムの買い／売りオーダーブック（価格、合計数量、レベルごとの注文数）を返します。

• hyperliquid_candles(coin, interval?, lookback_hours?, start_time?, end_time?) — Hyperliquid が保持する任意の期間の OHLCV ローソク足を返します。

• hyperliquid_funding_history(coin, lookback_hours?, start_time?, end_time?) — 実際に適用された資金調達率の時系列を返します（Hyperliquid では資金調達が 1 時間ごとに行われます）。

• hyperliquid_account_state(address) — 1 つのウォレットの無期限先物アカウントを返します。アカウント価値、想定元本、使用証拠金、出金可能額、すべてのオープンポジション（符号付き数量、エントリー価格、損益、レバレッジ、清算価格、累積資金調達額）が含まれます。

• hyperliquid_spot_balances(address, limit?) — 1 つのウォレットの現物トークンを返します。合計、注文で保留中の数量、利用可能数量、取得原価ベースの想定元本が含まれます。

• hyperliquid_account_history(address, period?, scope?) — 1 日／週／月／全期間のアカウント価値と損益を返します。開始値／終了値と取引量を先に表示します。

アカウント関連のツールは公開台帳を読み取ります。アドレスはオンチェーンの仮名識別子であり、Hyperliquid は認証情報なしで誰にでもその状態を提供しています。ここでアドレスと個人を結び付けることはありません。不明なアドレスには、単にゼロを返すのではなく、明示的に「アクティビティなし」と返します。

hyperliquid_account_state は 2 つのフラグで異なる 2 つの問いに答えるため、呼び出し側が一方からもう一方を推測する必要はありません。account_has_balance（無期限先物アカウントの価値がゼロではない。少額の未使用残高も含みます）と account_has_open_perp_positions（ポジションがオープンしている、または想定元本か使用証拠金がゼロではない）です。少額の資金があり、オープンポジションがないアドレスは true / false となります。

認証

キーは不要です。Hyperliquid の情報エンドポイント（POST api.hyperliquid.xyz/info）は、このパック内の読み取りに API キー、アカウント、署名のいずれも必要としません。

データソース

• https://api.hyperliquid.xyz/info — Hyperliquid の公開情報エンドポイントです。 上記の各ツールは、POST ボディでそれぞれ異なる type（ meta、spotMeta、allMids、metaAndAssetCtxs、l2Book、candleSnapshot、 fundingHistory）を送信します。URL はリソースごとにあるのではなく、1 つだけです。

次の呼び出し元が苦労して突き止めなくても済む情報：

• テストではリクエストごとのレート制限エラーは確認されていません — Hyperliquid の 公開ドキュメントでは、info エンドポイントに IP ベースの重み制限があると説明されて いますが、このパックでは 429 を特別扱いしていません。429 が返された場合、呼び出し元には Pipeworx 固有のメッセージではなく、Hyperliquid 独自のエラーボディがそのまま （httpError 経由で）返されます。
• 無期限先物と現物では、コイン ID の名前空間が異なりますが、coin 引数の 形式は同じです。 無期限先物はシンボルのみ（"BTC"、"ETH"）で指定します。 現物ペアは "@<index>"（例："@0"）で指定します。ただし、トークンごとに正規の ペアが 1 つあり、それには人が読める名前（"PURR/USDC"）もあります。正しい ID は hyperliquid_spot_meta の index フィールドから取得してください。現物ペアの @N ID を 別の場所での表示順から推測すると、上場日の順にインデックスが連続しているわけでは ないため、誤った ID になります。
• allMids のキーには、無期限先物のシンボルと現物の @N ID が混在しています — レスポンスには、それらを区別する type フィールドはありません。どのシンボルがどの 名前空間に属するかを事前に把握しておく必要があります（無期限先物の一覧は hyperliquid_perp_meta、現物の一覧は hyperliquid_spot_meta から取得します）。
• candleSnapshot は、startTime/endTime の期間に区間境界が含まれない場合、 エラーではなく [] を返します — たとえば、粒度が 1h で期間が 100ms の場合です。 これは正当な空の応答であり、呼び出しの失敗ではありません。期間を広げるか、より粗い インターバルを使用してください。
• 未決済建玉は米ドルではなく、ベース資産の単位で報告されます（たとえば、BTC の 数値 "37751.7" は、米ドルではなく 37,751.7 BTC の未決済建玉を意味します） — 米ドル換算の数値が必要な場合は、markPx を掛けてください。
• metaAndAssetCtxs は [meta, assetCtxs] の 2 要素配列を返し、 assetCtxs[i] は meta.universe[i] に対応します — 資産ごとのキーはありません。 先に universe でコインのインデックスを検索し、同じインデックスを assetCtxs で使用する必要があります。このパックでは hyperliquid_asset_context が その検索を行います。
• 過去の未決済建玉は個別に公開されていません — 利用できるのは現在の未決済建玉のみ （metaAndAssetCtxs／hyperliquid_asset_context 経由）です。 fundingHistory に相当する openInterestHistory エンドポイントはありません。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "hyperliquid": {
      "url": "https://gateway.pipeworx.io/hyperliquid/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/hyperliquid/mcp の tools/list は、上の表にあるツールに 加えて、共有 Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で 利用できるツール一式）も返します。そのため、表示されるツール数はこの表より多くなります。 現在、単一パックのエンドポイントには、パック独自のツールとともに、共有ツールが 約 30 個表示されます。接続時の initialize レスポンスには正確な対象範囲が示されており、 その日の状況を確認する際の決定的な情報になります。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使えば、 このパックでは対応していない質問にも、カタログ全体を対象にルーティングする ask_pipeworx 経由で回答できます。MCP サーバーを追加する必要はありません。 現在、メタツールを含めずにパックのエンドポイントを接続する方法はありません。 追加のスキーマによるコンテキスト消費が、ルーティングの利点を上回る場合は、 複数のパックエンドポイントではなく、ゲートウェイ全体に一度だけ接続してください。

または Pipeworx ゲートウェイ全体に接続すると、このパックのツールだけでなく、 各パックのすべてのツールが直接一覧表示されます：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1881 以上のデータソースにつながります。 唯一の違いは、どのパックのツールが直接一覧表示されるかです。 どちらから接続しても、ask_pipeworx ですべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/hyperliquid_perp_meta \
  -H 'Content-Type: application/json' \
  -d '{"coin":"BTC"}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/hyperliquid_perp_meta を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても動作します。Pipeworx アカウントも、ゲートウェイへの往復通信も必要ありません。

{
  "mcpServers": {
    "hyperliquid": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-hyperliquid"]
    }
  }
}

または、直接実行して起動することを確認します。

npx -y @pipeworx/mcp-hyperliquid

stdin/stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントだけでなく、ゲートウェイ全体でも機能します。

ask_pipeworx({ question: "your question about Hyperliquid data" })

ゲートウェイが適切なツールを選び、引数を自動で入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT