mcpField
G
grimoire-hyperliquid

grimoire-hyperliquid

github.com/franalgabaその他61.1k 回インストール25 週間前に更新
リポジトリ

grimoire-hyperliquid について

Grimoire のコマンドラインから Hyperliquid の市場データを取得し、Spell 用のスナップショット入力を生成するスキルです。状態を変更する出金コマンドには明示的な確認が必要で、Hyperliquid データや Spell のワークフローを扱う Agent とユーザー向けです。

主な機能

  1. 01無期限先物のミッド価格取得
  2. 02L2 オーダーブックと未決注文の照会
  3. 03無期限先物と現物のメタデータ
  4. 04Spell 入力用スナップショットコマンド
  5. 05確認必須の出金コマンド

活用シーン

  1. 01Hyperliquid の価格とオーダーブックの確認
  2. 02アドレスの未決注文の確認
  3. 03Spell 用スナップショット入力の準備
  4. 04明示的な確認後の出金

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/franalgaba/grimoire --skill grimoire-hyperliquid

インストール後、Claude Code で/grimoire-hyperliquidを入力して読み込まれたか確認します。

詳細

Grimoire Hyperliquid スキル

Hyperliquid のメタデータスナップショット、および明示的に要求された場合の出金にこのスキルを使用します。

推奨される呼び出し方法：

  • grimoire venue hyperliquid ...
  • npx -y @grimoirelabs/cli venue hyperliquid ...（インストール不要）
  • bun run packages/cli/src/index.ts venue hyperliquid ...（リポジトリ内）
  • grimoire-hyperliquid ...（@grimoirelabs/venues の直接バイナリ）

推奨される事前確認：

  • grimoire venue doctor --adapter hyperliquid --json
  • 状態を変更する操作（withdraw）の前に、HYPERLIQUID_PRIVATE_KEY が設定されていることを確認してください。

スナップショットの params: ブロックには --format spell を使用してください。

コマンド

読み取り専用データ：

  • grimoire venue hyperliquid mids — すべての無期限先物アセットの仲値
  • grimoire venue hyperliquid l2-book --coin <symbol> — コインの L2 オーダーブック
  • grimoire venue hyperliquid open-orders --user <address> — アドレスの未約定注文
  • grimoire venue hyperliquid meta — 無期限先物市場のメタデータ（ユニバース、証拠金テーブル）
  • grimoire venue hyperliquid spot-meta — 現物市場のメタデータ（トークン、ユニバース）

スナップショットコマンド（エージェント専用。spell の params: ブロックを生成します）：

  • grimoire venue hyperliquid mids-snapshot
  • grimoire venue hyperliquid l2-book-snapshot --coin <symbol>
  • grimoire venue hyperliquid open-orders-snapshot --user <address>
  • grimoire venue hyperliquid meta-snapshot
  • grimoire venue hyperliquid spot-meta-snapshot

状態を変更する操作：

  • grimoire venue hyperliquid withdraw --amount <usdc> --keystore <path> [--password-env <name>] [--destination <addr>]

例

grimoire venue hyperliquid mids --format table
grimoire venue hyperliquid mids --format spell
grimoire venue hyperliquid l2-book --coin BTC
grimoire venue hyperliquid l2-book --coin BTC --format spell
grimoire venue hyperliquid open-orders --user 0x0000000000000000000000000000000000000000
grimoire venue hyperliquid meta
grimoire venue hyperliquid mids-snapshot
grimoire venue hyperliquid l2-book-snapshot --coin BTC
grimoire venue hyperliquid meta-snapshot

spell の入力用に params: ブロックを出力するには、-snapshot バリアントを使用してください。これらはエージェント専用です（対話モードでは出力が抑制されます）。

Spell アクション

Hyperliquid では、注文の発注に op: "order" を指定した custom アクションタイプを使用します。

hyperliquid.custom(op="order", coin="ETH", price="3500", size="0.1", side="buy", order_type="Gtc")

アダプターは実行時制約（max_slippage など）をサポートしていません。注文パラメーターはアダプターの境界で検証されます。

サポートされている TIF 値：Gtc、Ioc、Alo、FrontendMarket

メトリックの対象範囲（Spell の比較）

Hyperliquid は、シンボルの中間価格を比較するために mid_price を公開します。

hl_mid = metric("mid_price", hyperliquid, ETH)

3 番目の引数には、読み取る Hyperliquid のシンボル（たとえば ETH、BTC、SOL）を指定します。

注意事項

  • withdraw は状態を変更する操作であり、ユーザーによる明示的な確認とキーストアの認証情報が必要です。
  • mids、l2-book、open-orders、meta、spot-meta は読み取り専用の情報呼び出しです。
  • スナップショットベースの spell 入力には --format spell を使用してください。
  • 自動化で meta／spot-meta を使用する場合は --format json を指定してください。--format table では、ネストされたペイロードの簡潔な概要が表示されます。
  • anvil／cast は EVM ツールであり、Hyperliquid の実行や診断には適用できません。

コメント

Markdown 対応