HL Portfolio API

Analysieren Sie Hyperliquid-Konten: Positionen, PnL, Fills, offene Orders, Funding. Vollständiger Clearinghouse-Zustand für jede Wallet. Die Portfolio-Ebene, die Agenten für Hyperliquid-Trading-Intelligenz benötigen. Pay-per-Call über x402 (USDC auf Base L2) – kein API-Schlüssel, keine Anmeldung, keine Rate-Limit-Beschränkung.

Teil des klymax402 Marketplaces – 100 x402-Micropayment-APIs für AI-Agents, eine Wallet, USDC auf Base.

Schnellstart – MCP

Fügen Sie dies zu Ihrer MCP-Client-Konfiguration hinzu (Claude Desktop, Cursor, ElizaOS, etc.):

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

Related MCP server: polskidegen-hl-tracker

Schnellstart – 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

Jeder x402-fähige Client (@x402/fetch, x402-agent-tools, ATXP) übernimmt den Zyklus „402 → Signatur → erneuter Versuch" automatisch.

Werkzeuge

hyperliquid_get_account_state

Verwenden Sie dies, wenn Sie den vollständigen Portfoliozustand eines Hyperliquid-Perpetual-Kontos abrufen müssen. Gibt den vollständigen Clearinghouse-Colocation-Zustand für jede Wallet-Adresse zurück, einschließlich Metriken auf Kontoebene und Details zu einzelnen Positionen.

Parameter

Beispielantwort:

{ 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" }] }

Wann verwenden: Zur Analyse des Risikos eines Traders, zur Prüfung der Margin-Gesundheit oder zur Bewertung der Portfolio-Allocation auf Hyperliquid. Unverzichtbar für die Bewertung von Copy Trading und das Risiko-Monitoring.

Nicht geeignet für: Handelsverlauf (verwenden Sie hyperliquid_get_trade_fills), offene Orders (verwenden Sie hyperliquid_get_open_orders), Funding-Zahlungen (verwenden Sie hyperliquid_get_user_funding), Vault-Performance (verwenden Sie hyperliquid_get_vault_details), Whale-Tracking (verwenden Sie hyperliquid_detect_whale_trades).

hyperliquid_get_trade_fills

Verwenden Sie dies, wenn Sie die letzten Handelsausführungen (Fills) für ein Hyperliquid-Perpetual-Konto abrufen müssen. Gibt die letzten Trades mit vollständigen Ausführungsdetails inklusive realisiertem PnL für geschlossene Positionen zurück.

Parameter

Beispielantwort:

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

Nicht geeignet für: aktuelle (verwenden Sie hyperliquid_get_account_state), offene/ausstehende Orders (verwenden Sie hyperliquid_get_open_orders), Funding-Zahlungen (verwenden Sie hyperliquid_get_user_funding).

hyperliquid_get_open_orders

Verwenden Sie dies, wenn Sie alle ausstehenden/offenen Orders für ein Hyperliquid-Perpetual-Konto sehen möchten. Gibt jede offene Order im Orderbuch mit vollständigen Order-Parametern zurück.

Parameter

Beispielantwort:

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

Nicht geeignet dafür: ausgeführte Trades (verwenden Sie hyperliquid_get_trade_fills), aktuelle Positionen (verwenden Sie hyperliquid_get_account_state).

hyperliquid_get_user_funding

Verwenden Sie dies, wenn Sie die Historie der Funding-Zahlungen für ein Hyperliquid-Perpetual-Konto abrufen müssen. Gibt alle erhaltenen oder gezahlten Funding-Zahlungen zurück; nützlich für die Berechnung der Funding-Einnahmen bzw. -Ausgaben und für die Bewertung der Rentabilität von Carry Trades.

Parameter

Beispielantwort:

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

Nicht geeignet für: aktuelle Positionen (verwenden Sie hyperliquid_get_account_state), Funding-Arbitrage-Möglichkeiten (verwenden Sie funding_arb_find_opportunities), Ausführungsverlauf (verwenden Sie hyperliquid_get_trade_fills).

Beispiel-Agent-Prompts

• „Vollständigen Portfolio-Zustand eines Hyperliquid-Perpetual-Kontos abrufen."

• „Letzte Handelsausführungen (Fills) für ein Hyperliquid-Perpetual-Konto abrufen."

• „Alle ausstehenden/offenen Orders für ein Hyperliquid-Perpetual-Konto anzeigen."

Zahlung

• Protokoll: x402 – HTTP-natives Pay-per-Call, keine Anmeldung, API-Schlüssel erforderlich.

• Netzwerk: Base L2 (eip155:8453)

• Asset: USDC

• Facilitator: Coinbase CDP (primär), PayAI (Fallback)

• Ebenso über ATXP erreichbar (OAuth-gebundelter x402, RFC-9728-Metadata für geschützte Ressourcen).

Teil von klymax402

100 x402-Micropayment-APIs für AI-Agents – eine einziger Wallet, USDC auf Base, keine Anmeldung.

• Katalog: https://klymax402.com/llms.txt

• Vollständige API-Referenz: https://klymax402.com/llms-full.txt

• Live-Statistiken: https://klymax402.com/stats

Lizenz

MIT