Skip to main content

​
Hyperliquid

ShanoneのHyperliquid連携では、パーペチュアルDEXであるHyperliquidを扱う34のツールをエージェントが利用できるようになります——アカウント/ポートフォリオ状態、マーケットデータ(オーダーブック、ローソク足、ファンディング)、注文管理、レバレッジ、TWAP注文まで対応します。

​
はじめに

1

ウォレットアドレスを取得する

Hyperliquidで使用している(または使用予定の)Ethereumウォレットアドレスをコピーします。
2

Shanoneに登録する

ShanoneダッシュボードのIntegrationsを開き、Hyperliquidを選択してウォレットアドレスを入力します。読み取り専用のアカウント・マーケットデータツールにはこれで十分です。
3

取引用の秘密鍵を設定する(任意)

注文の作成・変更には秘密鍵が必要ですが、これは通常の連携フォームではなく環境変数として別途設定されます——取引系ツールで認証エラーが出る場合はShanoneの管理者に確認してください。

​
利用可能なツール

ShanoneはHyperliquid用に34のツールを提供しており、以下のカテゴリに分類されています。
hyperliquid_get_account_state, hyperliquid_get_spot_balances, hyperliquid_get_portfolio, hyperliquid_get_subaccounts
hyperliquid_get_all_mids, hyperliquid_get_orderbook, hyperliquid_get_recent_trades, hyperliquid_get_candles
hyperliquid_get_perp_meta, hyperliquid_get_spot_meta, hyperliquid_get_asset_contexts
hyperliquid_get_fills, hyperliquid_get_fills_by_time, hyperliquid_get_funding_history, hyperliquid_get_user_fees, hyperliquid_get_rate_limit
hyperliquid_get_funding_rates, hyperliquid_get_funding_rate_history, hyperliquid_get_predicted_fundings
hyperliquid_get_open_orders, hyperliquid_get_order_status, hyperliquid_get_order_history, hyperliquid_place_order, hyperliquid_cancel_order, hyperliquid_cancel_orders_by_coin, hyperliquid_modify_order, hyperliquid_cancel_all_orders
hyperliquid_place_twap_order, hyperliquid_cancel_twap_order
hyperliquid_update_leverage, hyperliquid_update_isolated_margin, hyperliquid_close_position, hyperliquid_set_dead_mans_switch, hyperliquid_approve_api_wallet

​
よくある使い方

ポートフォリオ監視

複数のサブアカウントにわたるアカウント状態、現物残高、オープンポジションを確認する

マーケットスナップショット

意思決定の前にオーダーブックの深さ、直近の取引、ローソク足を取得する

自動注文管理

TWAP実行を含め、注文をプログラムで発注・変更・キャンセルする

リスク管理

レバレッジ/マージンモードを調整し、エージェントが応答不能になった場合に自動キャンセルするデッドマンスイッチを設定する

​
トラブルシューティング

読み取り専用ツールはウォレットアドレスのみで動作しますが、注文の発注/変更/キャンセルにはサーバー側で設定された秘密鍵が必要です——アカウントで取引が有効になっているか管理者に確認してください。
hyperliquid_get_subaccountsで正しいサブアカウントを確認しているか確認してください——パーペチュアルと現物の残高は別々に管理されており(hyperliquid_get_account_stateとhyperliquid_get_spot_balances)、誤った方を確認しがちです。
TWAP注文は即時執行ではなく指定した期間にわたって小分けに執行されます——即時約定を期待せずhyperliquid_get_order_statusで進行状況を追跡し、必要であればhyperliquid_cancel_twap_orderで早期に停止してください。