Hl Portfolio X402

HL Portfolio API

Hyperliquid アカウントを分析します。ポジション、PnL、約定、オープン注文、ファンディングを確認できます。任意のウォレットの完全なクリアリングハウス状態を取得します。Hyperliquid の取引インテリジェンスに必要な、エージェント向けのポートフォリオレイヤーです。x402 を通じた呼び出しごとの支払いに対応しています（Base L2 上の USDC）。API キーも登録も不要で、レート制限に阻まれることもありません。

klymax402 マーケットプレイスの一部です。AI エージェント向けの x402 マイクロペイメント API を 100 個提供し、1 つのウォレットで Base 上の USDC を利用できます。

クイックスタート -- MCP

MCP クライアントの設定（Claude Desktop、Cursor、ElizaOS など）に追加します。

{
  "mcpServers": {
    "hl-portfolio": {
      "url": "https://hl-portfolio.api.klymax402.com/mcp"
    }
  }
}

クイックスタート -- HTTP (x402)

curl -X POST "https://hl-portfolio.api.klymax402.com/api/account" \
  -H "Content-Type: application/json" \
  -d '{"address":"0x0000000000000000000000000000000000dEaD"}'
# -> 402 Payment Required, with an x402 payment challenge in the response body

x402 対応クライアント（@x402/fetch、x402-agent-tools、ATXP）は、402 → 署名 → 再試行のサイクルを自動的に処理します。

ツール

ツール	メソッド	パス	価格	説明
hyperliquid_get_account_state	POST	/api/account	$0.008	Hyperliquid ウォレットの完全なクリアリングハウス状態。ポジション、証拠金、PnL、レバレッジ、清算価格を確認できます。
hyperliquid_get_trade_fills	POST	/api/fills	$0.008	Hyperliquid ウォレットの最近の約定。コイン、売買方向、数量、価格、手数料、closedPnl、タイムスタンプを確認できます。
hyperliquid_get_open_orders	POST	/api/orders	$0.005	Hyperliquid ウォレットのオープン注文。コイン、売買方向、数量、価格、注文タイプ、reduce-only フラグを確認できます。
hyperliquid_get_user_funding	POST	/api/funding	$0.005	Hyperliquid ウォレットが受け取った、または支払ったファンディング。コイン、金額、レート、タイムスタンプを確認できます。

hyperliquid_get_account_state

Hyperliquid 無期限先物アカウントのポートフォリオ状態全体を取得する場合に使用します。任意のウォレットアドレスについて、アカウントレベルの指標とポジションごとの詳細を含む完全なクリアリングハウス状態を返します。

パラメーター

名前	型	必須	説明
address	string	yes	アカウント状態を取得する Hyperliquid ウォレットアドレス（0x...）

応答例：

{ accountValue: "125430.50", totalNtlPos: "89200.00", withdrawable: "36230.50", positions: [{ coin: "BTC", size: "1.5", entryPrice: "67500.00", unrealizedPnl: "2340.00", leverage: 5, liquidationPrice: "54200.00", marginType: "cross" }] }

使用する場面：トレーダーのリスクエクスポージャーの分析、証拠金の健全性の確認、Hyperliquid でのポートフォリオ配分の評価に使用します。コピー取引の評価やリスク監視に不可欠です。

対象外：取引履歴（hyperliquid_get_trade_fills を使用）、オープン注文（hyperliquid_get_open_orders を使用）、ファンディング支払い（hyperliquid_get_user_funding を使用）、ボールトのパフォーマンス（hyperliquid_get_vault_details を使用）、大口取引の追跡（hyperliquid_detect_whale_trades を使用）。

hyperliquid_get_trade_fills

Hyperliquid 無期限先物アカウントの最近の取引執行（約定）を取得する場合に使用します。決済済みポジションの実現 PnL など、執行に関する詳細を含む最新の取引を返します。

パラメーター

名前	型	必須	説明
address	string	yes	約定を取得する Hyperliquid ウォレットアドレス（0x...）
limit	number	no	返す約定の最大数（デフォルト：20、最大：100）

応答例：

{ fills: [{ coin: "ETH", side: "buy", size: "10.0", price: "3450.50", fee: "0.69", closedPnl: "0.00", timestamp: 1712000000000 }], count: 20 }

対象外：現在のポジション（hyperliquid_get_account_state を使用）、オープン中／保留中の注文（hyperliquid_get_open_orders を使用）、ファンディング支払い（hyperliquid_get_user_funding を使用）。

hyperliquid_get_open_orders

Hyperliquid 無期限先物アカウントの保留中／オープン注文をすべて確認する場合に使用します。板に残っているすべての注文について、注文パラメーターの全情報を返します。

パラメーター

名前	型	必須	説明
address	string	yes	オープン注文を取得する Hyperliquid ウォレットアドレス（0x...）

応答例：

{ orders: [{ coin: "BTC", side: "buy", limitPx: "65000.00", sz: "0.5", orderType: "limit", reduceOnly: false, oid: 123456 }], count: 3 }

対象外：執行済みの取引（hyperliquid_get_trade_fills を使用）、現在のポジション（hyperliquid_get_account_state を使用）。

hyperliquid_get_user_funding

Hyperliquid の無期限先物口座の資金調達料の支払い履歴を取得する場合に使用します。受け取りまたは支払いが発生した資金調達料の履歴をすべて返します。資金調達による収益・費用の計算や、キャリートレードの収益性の評価に役立ちます。

パラメーター

名前	型	必須	説明
address	string	はい	資金調達履歴を取得する Hyperliquid ウォレットアドレス（0x...）
startTime	number	いいえ	開始時点の Unix タイムスタンプ（ミリ秒）。省略した場合は過去 7 日間

応答例：

{ funding: [{ coin: "BTC", fundingRate: "0.0001", payment: "-1.35", timestamp: 1712000000000, positionSize: "1.5" }], totalReceived: "45.20", totalPaid: "-12.30", netFunding: "32.90" }

対象外：現在のポジション（hyperliquid_get_account_state を使用）、資金調達アービトラージの機会（funding_arb_find_opportunities を使用）、取引の実行履歴（hyperliquid_get_trade_fills を使用）。

エージェントのプロンプト例

• 「Hyperliquid の無期限先物口座のポートフォリオ状態をすべて取得する」
• 「Hyperliquid の無期限先物口座の最近の取引執行（約定）を取得する」
• 「Hyperliquid の無期限先物口座の保留中／未約定の注文をすべて確認する」

支払い

• プロトコル：x402 -- HTTP ネイティブの従量課金。サインアップ不要、API キー不要
• ネットワーク：Base L2（eip155:8453）
• 資産：USDC
• ファシリテーター：Coinbase CDP（プライマリ）、PayAI（フォールバック）
• ATXP 経由でも利用可能（OAuth でラップされた x402、RFC 9728 の保護対象リソースメタデータ）

klymax402 の一部

AI エージェント向けの x402 マイクロペイメント API 100 種類 -- 1 つのウォレット、Base 上の USDC、サインアップ不要。

• カタログ：https://klymax402.com/llms.txt
• API リファレンス全文：https://klymax402.com/llms-full.txt
• ライブ統計：https://klymax402.com/stats

ライセンス

MIT