HL Portfolio API

Hyperliquidアカウントを分析: ポジション、PnL、約定、オープンオーダー、ファンディング。任意のウォレットの完全なクリアリングハウス状態を取得できます。エージェントがHyperliquidの取引インテリジェンスに必要とするポートフォリオレイヤーです。x402による1リクエストごとの課金(Base L2上のUSDC) -- APIキー不要、登録不要、レート制限の壁もありません。

klymax402マーケットプレイスの一部です -- AIエージェント向けの100のx402マイクロペイメントAPI、1つのウォレット、BaseIOP上のUSDC。

クイックスタート -- MCP

MCPクライアントの設定(Claude Desktop、Cursor、ElizaOSなど)に追加します:

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

Related MCP server: polskidegen-hl-tracker

クイックスタート -- 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

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

パラメータ

レスポンス例:

{ 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を含む、完全な執行詳細な情報を含む最新の取引を返します。

パラメータ

レスポンス例:

{ 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の永続先物(パーペチュアル)アカウントのすべての保留中・オープンオーダーを確認する場合に使用します。オーダーブックに残っているすべての注文を、完全な注文パラメータとともに返します。

パラメータ

レスポンス例:

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

使用すべきではない場面: 約定済みの取引(hyperliquid_get_trade_fillsAtを使用)、現在のポジション(hyperliquid_get_account_stateを使用)。

hyperliquid_get_user_funding

Hyperliquidの永続先物(パーペチュアル)アカウントのファンディング支払い履歴を取得する場合に使用します。受け取りまたは支払ったすべてのファンディングレート支払いを返し、ファンディング収入・費用の計算やキャリートレードの収益性評価に役立ちます。

パラメータ

レスポンス:

{ 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 -- サインアップ不要・APIキー不要の、HTTPネイティブな1通話ごとの支払い

• ネットワーク: Base L2(eip155:8453)

• アセット: USDC

• ファシリテーター: Coinbase CDP(プライマリ)、PayAI(フォールバック)

• ATXP経由でも利用可能です(OAuth wrapped x402、RFC 9728 protected-resource metadata)

klymax402の一部

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

• カタログ: https://klymax402.com/llms.txt

• 完全なAPIリファレンス: https://klymax402.com/llms-full.txt

• ライブ統計: https://klymax402.com/stats

ライセンス

MIT