hyperliquid について
Hyperliquid via Dwellirは、DwellirのHyperliquidインフラを利用する開発者向けのリファレンスです。EVM RPC、市場データAPI、gRPCフィード、板情報ストリーム、CLIでのエンドポイントとキー管理を解説します。
主な機能
- 01HyperEVM JSON-RPCへのアクセス
- 02Info APIによる市場・ユーザーデータ照会
- 03HypercoreのgRPCデータストリーム
- 04リアルタイム板情報WebSocket
- 05エンドポイント検索とAPIキー管理
- 06専用ノードの選択肢
活用シーン
- 01HyperEVMの状態やコントラクトの照会
- 02市場データアプリの構築
- 03板情報やHypercoreデータのストリーミング
- 04ターミナルでのエンドポイント検索とキー管理
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ dwellir-public/ hyperliquid-skills --skill hyperliquidインストール後、Claude Code で/hyperliquidを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
LICENSEREADME.mdreferences/historical-data.mdhyperevm-json-rpc.mdgrpc-gateway.mdinfo-api.mddwellir-cli.mdnative-api.mdorderbook-websocket.mdskills/hyperliquid-data/LICENSE詳細
Dwellir 経由で利用する Hyperliquid
Hyperliquid は、取引に最適化された専用の L1 ブロックチェーンです。Dwellir は独自の Hyperliquid ノードを運用し、標準的な RPC にとどまらないインフラを提供しています。Hypercore データ用のカスタム gRPC ゲートウェイ、リアルタイムのオーダーブックサーバー、フィルタリング機能を備えた Info API プロキシを提供しており、シンガポールと東京にエッジサーバーを設置しています。
Hyperliquid の仕組み
Hyperliquid は 2 つのレイヤーで構成されています。
HyperCore はネイティブの取引レイヤーです。無期限先物と現物のオーダーブックは完全にオンチェーンで動作します。すべての注文、キャンセル、取引、清算は 1 ブロック以内に決済されます。HyperBFT コンセンサスにより、サブ秒のファイナリティで毎秒約 200,000 件の注文を処理します。
HyperEVM は、HyperCore と並行して動作する汎用 EVM スマートコントラクトレイヤーです。開発者は、HyperCore の流動性と連携する Solidity コントラクトをデプロイできます。チェーン ID:999。ネイティブのガストークン:HYPE。
主な特性:
- すべてのオーダーブックが完全にオンチェーン(オフチェーンでのマッチングなし)
- サブ秒のブロック時間と 1 ブロックでのファイナリティ
- 無期限先物は最大 40 倍のレバレッジ(BTC)に対応。ほとんどの資産は 3~10 倍
- HIP-3 DEX のデプロイに対応したネイティブの現物取引
Dwellir が提供するもの
Dwellir は、公式の HL ノードに加え、特定のデータチャネルを配信するために Dwellir とコミュニティが開発したカスタムソフトウェアを含む、Hyperliquid のフルインフラを運用しています。
料金、機能、サービスの詳細については、Dwellir の Hyperliquid ドキュメントと料金をご覧ください。
| エンドポイント | 提供する内容 | プロトコル | リファレンス |
|---|---|---|---|
| HyperEVM JSON-RPC | EVM の状態、スマートコントラクト、ブロック | HTTPS + WSS | hyperevm-json-rpc.md |
| Info API プロキシ | 市場データ、ユーザーの状態、メタデータ | HTTPS (POST) | info-api.md |
| L1 gRPC Gateway | Hypercore の生フィード + 型付き市場ストリーム(V3、V2 互換) | gRPC + x-api-key | grpc-gateway.md |
| Orderbook WebSocket | リアルタイムの L2/L4/BBO オーダーブックデータ + 取引 | WSS のみ | orderbook-websocket.md |
| Dedicated Node | フルスタック、スループット上限なし | すべて | 以下を参照 |
Dwellir CLI
Dwellir CLI(dwellir)を使うと、エンドポイントの検索、API キー管理、使用状況の監視、ドキュメントの参照をターミナルから行えます。Hyperliquid のエンドポイント URL をすばやく見つけたり、ターミナルを離れずにドキュメントを読んだり、CI パイプラインでキーを管理したりするのに便利です。dwellir-cli.mdをご覧ください。
# Install
curl -fsSL https://raw.githubusercontent.com/dwellir-public/cli/main/scripts/install.sh | sh
# Find all Hyperliquid endpoints
dwellir endpoints search hyperliquid
# Read Hyperliquid docs as markdown
dwellir docs search hyperliquid
dwellir docs get hyperliquid/info-endpoint
# Manage API keys and check usage
dwellir keys list
dwellir usage summary
Dwellir がプロキシしないもの
Exchange API:注文の発注、キャンセル、送金などの書き込み操作には EIP-712 署名が必要で、api.hyperliquid.xyz/exchange に直接送信します。native-api.mdをご覧ください。
Native WebSocket:ユーザーイベント、取引、ローソク足を取得する Hyperliquid のサブスクリプション WebSocket(wss://api.hyperliquid.xyz/ws)は、Dwellir の Orderbook WebSocket とは別のものです。native-api.mdをご覧ください。
読み取りと書き込みのアーキテクチャ
┌─────────────────────────────────────────────────────────┐
│ Your Application │
├──────────────────┬──────────────────────────────────────┤
│ READ (Dwellir) │ WRITE (Hyperliquid native) │
│ │ │
│ EVM state ──────┤ Place orders ─── api.hyperliquid.xyz │
│ Info queries ───┤ Cancel orders /exchange │
│ gRPC streams ───┤ Transfers (requires sig) │
│ Order book ─────┤ Set leverage │
└──────────────────┴──────────────────────────────────────┘
用途に応じたリファレンスの選び方
| 目的 | 使用するリファレンス |
|---|---|
| HyperEVM で Solidity コントラクトをデプロイまたは操作する | hyperevm-json-rpc.md |
| EVM の状態(残高、ログ、ブロック)を照会する | hyperevm-json-rpc.md |
| 市場データ(価格、オーダーブック、ローソク足、資金調達率)を取得する | info-api.md |
| ユーザーのポジション、注文、約定、残高を照会する | info-api.md |
| 無期限先物/現物のメタデータ(ユニバース、レバレッジ、資産)を取得する | info-api.md |
| 詳細なレベルを含むオーダーブックの更新をリアルタイムでストリーミングする | orderbook-websocket.md |
| マーケットメイクまたはアービトラージのシステムを構築する | orderbook-websocket.md |
| L1 ブロックデータまたは約定の実行をストリーミングする | grpc-gateway.md |
| Hypercore からインデクサーやデータパイプラインを構築する | grpc-gateway.md |
| 注文を発注、キャンセル、変更する | native-api.md |
| ユーザーイベント、取引、ローソク足の更新をサブスクライブする | native-api.md |
| 過去の取引/約定データにアクセスする | historical-data.md |
| エンドポイント URL の確認、API キーの管理、またはターミナルからドキュメントを読む | dwellir-cli.md |
専用ノード
シングルテナントのインフラストラクチャ上で、Hyperliquid のフルスタックを利用できます。共有のレート制限がなく、スループットは無制限です。東京(メインネット)およびテストネット構成で利用できます。
専用ノードには、分離されたインフラストラクチャ上のすべての Dwellir サービス(EVM JSON-RPC、Info API、gRPC Gateway、Orderbook Server)が含まれます。
最新の料金と構成オプションについては、Dwellir Hyperliquid Pricingをご覧ください。
営業窓口にお問い合わせいただくか、dashboard.dwellir.comからご登録ください。
ベストプラクティス
-
読み取りには Dwellir を、書き込みには Hyperliquid ネイティブを使用します。 Dwellir はデータインフラストラクチャを提供します。注文の発注には署名が必要で、
api.hyperliquid.xyz/exchangeを経由します。 -
レイテンシが重要なストリーミングには gRPC ゲートウェイを使用します。 gRPC エンドポイントはディスクから読み取り、Info API への HTTP ポーリングよりも低レイテンシです。
-
オーダーブックデータには Dwellir の Orderbook WebSocket を使用します。 シンガポールと東京にエッジサーバーを備え、オーダーブックの配信に最適化されています。
-
Info API のクエリはまとめて実行します。 資産ごとにクエリするのではなく、
metaAndAssetCtxsなどの結合エンドポイント(パブリック API 経由)を取得します。Dwellir プロキシとパブリックエンドポイントで利用できるタイプについては、Info API docsをご確認ください。 -
メタデータをキャッシュします。
meta、spotMeta、perpDexsは準静的です。1~5 分間キャッシュしてください。 -
スナップショットには Info API 経由の
l2Bookを、ストリーミングには Orderbook WS を使用します。 Info API は特定時点のスナップショットを提供し、Orderbook WebSocket は継続的な更新を提供します。
ドキュメントへのリンク
- Dwellir Hyperliquid のドキュメント:dwellir.com/docs/hyperliquid
- Dwellir L1 gRPC Gateway:ソースへのアクセスについては [email protected] までお問い合わせください
- Dwellir Orderbook Server:ソースへのアクセスについては [email protected] までお問い合わせください
- Dwellir REST Server:ソースへのアクセスについては [email protected] までお問い合わせください
- Hyperliquid API のドキュメント:hyperliquid.gitbook.io
- Hyperliquid Python SDK:github.com/hyperliquid-dex/hyperliquid-python-sdk
- Dwellir ダッシュボード:dashboard.dwellir.com
- Dwellir サポート:[email protected]