hyperliquid-reader

Hyperliquid リーダー（読み取り専用）

ホストが以下のシェルプローブをまだ実行していない場合（たとえば Codex）、セットアップ方法を選ぶ前に、シェルツールを使って ! で囲まれたコマンドを実行してください。実際の出力を使用してください。シェルにアクセスできない場合は、その制限を報告してください。

opencli と、このリポジトリの opencli-plugins/hyperliquid ツリーにある hyperliquid プラグイン（opencli 組み込みのアダプターとは別のプラグインで、opencli のモノレポサブパス構文を使ってインストールします）を介して、オンチェーンのパープ／現物 DEX である Hyperliquid の市場データを読み取ります。

このスキルは読み取り専用で、市場データのみを扱います。 分析のために、Hyperliquid の完全に公開された情報 API から市場テーブル、資金調達率、オーダーブック、ローソク足を読み取ります。個々のアカウントの読み取り、注文の発注・変更・キャンセル、資金の移動は行いません。このプラグインに取引機能はありません。注文の発注には、アダプターが一切呼び出さない別のエンドポイントで、ウォレット署名付きのアクションが必要です。

仕組み：各コマンドは { "type": "..." } の本文を使って POST https://api.hyperliquid.xyz/info を1回実行し、レスポンスを正規化します。API キー、ウォレット、ログイン、アプリの起動は不要です。情報 API は公開されています。

---

ステップ 1：opencli とプラグインがインストールされ、準備ができていることを確認する

現在の環境の状態：

!`(command -v opencli && opencli hyperliquid markets --coin BTC -f json 2>&1 | head -3 && echo "READY" || echo "SETUP_NEEDED") 2>/dev/null || echo "NOT_INSTALLED"`

上記の状態が READY の場合は、ステップ 2 に進んでください。それ以外の場合：

NOT_INSTALLED — opencli をインストールする

npm install -g @jackwener/opencli

Node.js >= 24 が必要です。hyperliquid プラグインは engines.node >= 24 を宣言しています。

SETUP_NEEDED — Hyperliquid プラグインをインストールする

Hyperliquid アダプターは opencli に組み込まれていません。別のプラグインです。

opencli plugin install github:himself65/finance-skills/hyperliquid

これでセットアップは完了です。認証も起動手順もありません。opencli hyperliquid markets --coin BTC で確認してください。

セットアップでよくある問題

症状	対処法
opencli: command not found	npm install -g @jackwener/opencli（Node ≥ 24）
Unknown command: hyperliquid	opencli plugin install github:himself65/finance-skills/hyperliquid
hyperliquid info 429	レート制限中です。数秒待ってから再試行してください。

---

ステップ 2：ユーザーのニーズを特定する

ユーザーのリクエスト	コマンド	主なフラグ
パープ市場の概要／出来高上位	opencli hyperliquid markets	--sort、--limit、--coin
1つのパープの価格＋資金調達率＋OI	opencli hyperliquid markets --coin BTC	—
現物ペアの概要	opencli hyperliquid spot-markets	--sort、--limit、--pair、--canonical-only
現在の全ミッド価格	opencli hyperliquid mids	--coin <substring>
コインのオーダーブック	opencli hyperliquid book --coin ETH	--depth、--n-sig-figs
OHLCV ローソク足	opencli hyperliquid candles --coin BTC --interval 1h	--limit
コインの過去の資金調達率	opencli hyperliquid funding-history --coin BTC	--hours、--limit
資金調達率の裁定：HL 対 Binance 対 Bybit	opencli hyperliquid funding-compare	--coin、--sort、--limit

---

ステップ 3：コマンドを実行する

基本パターン

# Use -f json or -f yaml for structured output
opencli hyperliquid markets --sort fundingAprPct --limit 15 -f json
opencli hyperliquid funding-compare --sort hlVsBinancePct --limit 20 -f md
opencli hyperliquid candles --coin BTC --interval 4h --limit 50 -f csv
opencli hyperliquid book --coin ETH --depth 5 -f json

重要なルール

1. コインシンボルはパープ名のみです — BTC、ETH、SOL、HYPE（取引所の接頭辞は付きません）。現物ペアはBASE/USDCです（例：PURR/USDC）。book／candlesには、パープコインまたは現物ペアのどちらも指定できます。
2. 「Xや市場の状況はどうか」を調べるときは、marketsをデフォルトで使います — パープごとに1行で、マーク／オラクル／ミッド価格、24時間変動率、1時間あたりのファンディングレートとAPR、建玉（コイン数と想定元本）、24時間取引高をまとめて表示します。単一の資産に絞り込むには--coinを指定します。
3. ファンディングは2通りで表示されます — fundingHrPctは1時間あたりの生レートをパーセントで示します。fundingAprPctはこれを年率換算した値です（hourly × 24 × 365）。資産間のキャリーを比較する場合はAPRを、次の1時間に支払う額を知りたい場合は1時間あたりの値を基準にしてください。
4. funding-compareはファンディングの裁定取引を調べる画面です — 各取引所の間隔（HLは1時間、Binance／Bybitは通常4時間）で年率換算し、hlVsBinancePct／hlVsBybitPctのスプレッドを表示します。デフォルトの並べ替えでは、HLとBinanceのスプレッドを絶対値で評価し、乖離が最も大きいものを先頭にします。hlVsBinancePctが正の値の場合、HLのロングポジションはBinanceのロングポジションより多く支払います。
5. bookは片側あたり10段をデフォルトで表示します — 表示段数を増やすには--depth（最大20）を、価格レベルを集約するには--n-sig-figs 2..5を指定します。最良買い気配と最良売り気配からスプレッド／ミッド価格を計算してください。
6. candlesは、指定した--intervalの最新の--limit本のローソク足を取得します（デフォルトは1h、100本）。有効な間隔：1m 3m 5m 15m 30m 1h 2h 4h 8h 12h 1d 3d 1w 1M。最大5000本です。
7. プログラムでの処理や他のスキルへの入力には-f jsonを使用します。人間が読みやすい出力には-f mdまたは-f tableを使用します。
8. 読み取り専用の市場データです。 アカウント情報の読み取り、注文の発注・変更・キャンセル、送金には対応していません。このプラグインには意図的に書き込み用エンドポイントが公開されていないため、回避策を探さないでください。

出力形式フラグ（-f）

形式	フラグ	最適な用途
テーブル	-f table（デフォルト）	人間が読みやすいターミナル出力
JSON	-f json	プログラムでの処理、LLMのコンテキスト
YAML	-f yaml	構造化された読みやすい出力
Markdown	-f md	レポート
CSV	-f csv	スプレッドシートへのエクスポート

出力列

• markets — coin、markPx、midPx、oraclePx、change24hPct、fundingHrPct、fundingAprPct、openInterest、oiNotional、dayNtlVlm、premiumPct、maxLeverage
• spot-markets — pair、base、markPx、midPx、change24hPct、dayNtlVlm、circulatingSupply、marketCap、canonical
• mids — coin、mid
• book — side、level、px、sz、orders
• candles — time、open、high、low、close、volume、trades
• funding-history — coin、fundingRatePct、fundingAprPct、premiumPct、time
• funding-compare — coin、hlAprPct、binanceAprPct、bybitAprPct、hlVsBinancePct、hlVsBybitPct、nextHlFunding

---

ステップ 4：結果を提示する

1. 見出しの数値を先に示し、その後に表を続けます。 markets --coin BTC の場合は、マーク価格、24時間の変動率、資金調達率の APR、建玉をまず文章で述べます。markets の全件出力の場合は、件数と、値動きの大きい銘柄／資金調達率の高い銘柄を先に示します。
2. 資金調達率はキャリーの観点で説明します — 例：「BTC 無期限先物の資金調達率は APR +10.9％です（ロングがショートに支払います）」。資金調達率がプラスの場合はロングがショートに支払い、マイナスの場合はショートがロングに支払います。
3. funding-compare では、乖離幅が最も大きいものから提示します — 銘柄、両取引所の APR、スプレッドを示し、スプレッドは年率換算であることを忘れないでください。実際の裁定取引では取引所や出金に伴うコストも発生するため、確実な利益ではなくスクリーニング結果として提示します。
4. book ではスプレッドを報告します — すべての板のレベルを出力する前、またはその代わりに、最良買値、最良売値、仲値、スプレッド（bps）を示します。求められない限り、20 レベルを貼り付けないでください。
5. candles では値動きを説明します — 最初と最後の終値、高値／安値、方向を示します。全 OHLCV 表は、ユーザーが時系列データを求めた場合にのみ表示します。
6. 表示前に積極的に絞り込みます — markets には約 180 件の無期限先物が、mids には約 700 件の市場があります。ユーザーが全件を求めない限り、関連する並べ替え基準で上位 15～20 件に絞ります。
7. 取引判断のために相互参照します — Hyperliquid はオンチェーン取引所です。株式／オプションの観点では、tradingview-reader スキルと組み合わせます。資金調達率／ベーシス取引では、funding-compare と markets（プレミアム、OI）を中核的な確認画面として使います。

---

ステップ 5：診断

opencli hyperliquid markets --coin BTC

BTC の行が正常に表示されれば、opencli、プラグイン、パブリック API のすべてに接続できています。Unknown command: hyperliquid というエラーが出た場合は、プラグインを再インストールします（ステップ 1）。hyperliquid info 4xx/5xx は上流 API の問題です。少し待ってから再試行してください。

---

エラーリファレンス

エラー	原因	対処方法
Unknown command: hyperliquid	プラグインがインストールされていない	opencli plugin install github:himself65/finance-skills/hyperliquid
hyperliquid info 429	レート制限	数秒待ってから再試行
hyperliquid info 422/500	リクエスト本文の形式不正、または上流の問題	銘柄／間隔を再確認し、少し待ってから再試行
No perp market for coin "X"	シンボルが間違っているか、登録されていない	正確なシンボルを確認するには、opencli hyperliquid markets（または mids）を実行します

---

リファレンスファイル

• references/commands.md — すべてのコマンドと全フラグ、出力スキーマ、アナリスト向けワークフロー（資金調達率キャリー、ベーシス／裁定取引、現物スナップショット）