Hyperliquid API Einstieg: Anfänger-Guide 2026

• Hyperliquid API
• Hyperliquid API Guide
• Hyperliquid API Tutorial
• On-Chain Trading API

Wenn du schon einmal darüber nachgedacht hast, On-Chain Perpetuals programmatisch zu handeln, gehört die Hyperliquid API derzeit zu den DEX-APIs, die sich am ehesten wie eine zentrale Exchange anfühlen. Sie bietet Endpoints für Marktdaten, Account-Informationen und Order-Management sowie WebSocket-Streams für Echtzeitdaten. Damit lassen sich einfache Quant-Strategien, Monitoring-Tools oder auch komplexere Market-Making-Setups umsetzen.

Dieser Guide richtet sich an Entwicklerinnen und Entwickler, die zum ersten Mal mit der Hyperliquid API arbeiten. Du bekommst einen Überblick über die API-Struktur, Authentifizierung, einfache Beispiele und typische Stolperfallen. Für die praktische Nutzung und das Risikomanagement empfehlen wir, API-Workflows nicht isoliert zu betrachten, sondern mit einer sicheren Wallet- und Trading-Umgebung wie OneKey und OneKey Perps zu kombinieren.

Was kann die Hyperliquid API?

Laut Hyperliquid-Dokumentation lässt sich die API grob in drei Bereiche einteilen:

Info Endpoints: Diese Endpoints liefern Marktdaten und Account-Informationen, zum Beispiel aktuelle Orderbook-Snapshots, recente Trades, Funding-Rate-Historie, Positionen und historische Orders. Sie sind öffentlich zugänglich und benötigen keine Signatur.

Exchange Endpoints: Darüber laufen schreibende Aktionen wie Orders platzieren, Orders canceln, Leverage ändern oder Margin anpassen. Diese Requests müssen mit der Wallet signiert werden und erfordern entsprechend sorgfältiges Key-Management.

WebSocket Streams: Über WebSocket kannst du Echtzeitdaten abonnieren, etwa Orderbook-Updates, Trades oder Account-Events. Das ist wichtig für Strategien, die schnell auf Marktveränderungen reagieren müssen.

Base URL und API-Struktur

Die REST API von Hyperliquid nutzt diese Base URL:

https://api.hyperliquid.xyz

Alle Requests werden per POST gesendet, der Request Body ist JSON. Info-Requests gehen an:

/info

Exchange-Requests gehen an:

/exchange

Die genauen Felder, Typen und Parameter solltest du immer mit der offiziellen Dokumentation abgleichen. Die Beispiele unten sind als Einstieg gedacht und ersetzen keine Prüfung der aktuellen API-Spezifikation.

Authentifizierung

Hyperliquid verwendet für Trading-Requests EIP-712 Structured Data Signatures statt eines klassischen API-Key-plus-Secret-Modells. Das bedeutet:

• Du brauchst eine Ethereum-kompatible Wallet-Adresse als Identität.
• Jede Trading-Anfrage muss mit dem passenden Private Key signiert werden.
• Die Signatur beweist, dass der Request vom autorisierten Inhaber der Adresse stammt.

Dieses Modell vermeidet gestohlene API Keys als separates Risiko, verschiebt aber die Verantwortung direkt auf dein Private-Key-Management. Wenn der Private Key kompromittiert wird, kann ein Angreifer gültige Signaturen erzeugen und deinen Account steuern.

Genau hier ist OneKey relevant. Eine OneKey Hardware Wallet isoliert Private Keys in einem sicheren Chip; Signaturen werden auf dem Gerät erzeugt, ohne dass der Private Key den Host oder das Netzwerk berührt. Für aktive API-Trader kann es sinnvoll sein, dedizierte Sub-Accounts oder separate Wallets für API-Trading zu verwenden, statt das Hauptkonto direkt zu exponieren.

Für manuelle Kontrolle, Positionsüberblick und Perps-Trading ist OneKey Perps ein praktischer Workflow: Du kannst deine Wallet-Sicherheit mit einer Trading-Oberfläche kombinieren und API-Aktivitäten besser von langfristigen Beständen trennen.

Info-Abfrage: Beispiel mit curl und Python

Ein einfacher Startpunkt ist die Abfrage der Metadaten aller handelbaren Assets.

Mit curl:

curl -X POST https://api.hyperliquid.xyz/info \
  -H "Content-Type: application/json" \
  -d '{"type": "meta"}'

Mit Python und requests:

import requests
import json

url = "https://api.hyperliquid.xyz/info"
payload = {"type": "meta"}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)
data = response.json()

print(json.dumps(data, indent=2))

Die Antwort enthält Basisinformationen zu handelbaren Kontrakten, etwa Asset-Namen, maximale Leverage und minimale Ordergrößen. Diese Abfragen sind öffentlich und benötigen keine Authentifizierung. Daher sind sie der beste Einstieg in die Hyperliquid API.

Account-Positionen abfragen

Auch die Abfrage des Positionsstatus einer bestimmten Adresse gehört zu den Info Endpoints. Du musst dafür nur die Wallet-Adresse angeben:

payload = {
    "type": "clearinghouseState",
    "user": "0xYOUR_WALLET_ADDRESS"
}

response = requests.post(url, json=payload, headers=headers)

Die Antwort enthält unter anderem Margin-Balance, Positionsgrößen und unrealisierten PnL. Wichtig: Diese Daten sind öffentlich einsehbare On-Chain- beziehungsweise DEX-Daten. Jeder kann für jede Adresse entsprechende Informationen abfragen.

WebSocket-Realtime-Subscriptions

Der WebSocket Endpoint lautet:

wss://api.hyperliquid.xyz/ws

Nach dem Verbindungsaufbau sendest du eine Subscription Message, um Echtzeitdaten zu erhalten:

import asyncio
import websockets
import json

async def subscribe_orderbook():
    uri = "wss://api.hyperliquid.xyz/ws"

    async with websockets.connect(uri) as ws:
        sub_msg = {
            "method": "subscribe",
            "subscription": {
                "type": "l2Book",
                "coin": "BTC"
            }
        }

        await ws.send(json.dumps(sub_msg))

        while True:
            msg = await ws.recv()
            data = json.loads(msg)
            print(data)

asyncio.run(subscribe_orderbook())

Typische abonnierbare Daten sind unter anderem:

• L2 Orderbook (l2Book)
• Trades (trades)
• Account-Events (userEvents, mit entsprechender Adresse)
• globale Funding-Daten

Häufige Stolperfallen

Falsches Request-Format: Hyperliquid ist bei JSON-Feldern, Typen und Namen strikt. Ein Integer als String oder ein falsch benanntes Feld kann dazu führen, dass ein Request abgelehnt wird. Fehlermeldungen sind nicht immer selbsterklärend, daher solltest du bei Problemen zuerst die Dokumentation und das exakte Payload-Format prüfen.

Signatur-Erzeugung: EIP-712-Signaturen haben Details wie Type Definitions und Domain Separator. Eine eigene Implementierung ist fehleranfällig. Für die meisten Projekte ist es sinnvoller, ein gepflegtes Hyperliquid SDK aus der Community oder von offizieller Seite zu verwenden, etwa für Python oder JavaScript.

Zeitstempel-Synchronisierung: Trading-Requests enthalten häufig einen aktuellen Timestamp und sind nur für ein begrenztes Zeitfenster gültig. Wenn deine lokale Systemzeit deutlich abweicht, können Requests als abgelaufen abgelehnt werden. Nutze zuverlässige Zeitsynchronisierung auf Produktionssystemen.

Netzwerkfehler: WebSocket-Verbindungen können abbrechen, REST-Requests können temporär fehlschlagen. Produktionscode sollte Reconnects, Retry-Logik, Backoff-Strategien und sauberes State-Handling enthalten.

Rate Limits im Überblick

Hyperliquid verwendet je nach Endpoint-Typ unterschiedliche Rate Limits. Die konkreten Werte solltest du in der aktuellen offiziellen Dokumentation prüfen. Grundsätzlich sind Info-Endpunkte meist großzügiger limitiert, während Exchange-Endpunkte strenger behandelt werden.

Strategien mit häufigem Order-Platzieren und Canceln müssen Rate Limits besonders ernst nehmen. Bei einem 429-Fehler solltest du Requests sofort verlangsamen und eine Exponential-Backoff-Strategie verwenden, statt stur weiter zu retryen.

Empfehlungen für die Entwicklungsumgebung

Bevor du eine Strategie produktiv einsetzt, solltest du einige Grundregeln beachten:

Teste zuerst mit kleinen Positionen. Starte nicht direkt mit großem Kapital. Für Hyperliquid wird berichtet, dass es derzeit kein separates Testnet für Perpetual-Trading-Tests gibt. Deshalb solltest du erste Live-Tests nur mit sehr begrenztem Risiko durchführen.

Isoliere Signing Keys und Hauptvermögen. Verwende für API-Trading einen dedizierten Sub-Account oder eine separate Adresse. So begrenzt du die potenzielle Schadenshöhe, falls deine Strategie, Infrastruktur oder Signatur-Logik Fehler enthält. Mit der Multi-Account-Verwaltung von OneKey lässt sich diese Trennung übersichtlich umsetzen.

Nutze OneKey Perps als praktischen Kontroll-Workflow. Auch wenn deine Strategie über die API läuft, brauchst du eine verlässliche Oberfläche, um Positionen, Risiko und manuelle Eingriffe im Blick zu behalten. OneKey Perps eignet sich dafür als sicherheitsbewusster Perps-Workflow in Kombination mit deiner Wallet.

Sieh dir Open-Source-Referenzen an. OneKey GitHub kann als Referenz dienen, wenn du verstehen möchtest, wie Wallet-Signaturen sicher in Anwendungen integriert werden können.

Wenn du OneKey noch nicht nutzt, kannst du OneKey für Desktop oder Mobile herunterladen, deine Accounts sauber trennen und OneKey Perps als praktische Umgebung für Perps-Interaktionen testen. Das ist kein Ersatz für eigenes Risikomanagement, aber eine sinnvolle Sicherheitsbasis.

FAQ

Q1: Brauche ich für die Hyperliquid API einen registrierten Account?

Nein, nicht im klassischen Sinn. Du brauchst eine Ethereum-kompatible Wallet-Adresse. Sobald diese Adresse auf Hyperliquid ihre erste Aktion durchgeführt hat, etwa eine Einzahlung, kann sie für API-Interaktionen genutzt werden. Ein traditioneller Login mit E-Mail, Passwort oder KYC ist dafür nicht erforderlich.

Q2: Gibt es ein fertiges Python SDK für die Hyperliquid API?

Ja, es gibt SDKs aus der Community und von offizieller Seite. Am besten prüfst du die aktuelle Hyperliquid GitHub-Seite oder die offizielle Dokumentation, um eine gepflegte Version zu finden. Ein SDK reduziert den Aufwand für Signaturaufbau, Request-Formatierung und Fehlerbehandlung deutlich.

Q3: Wie baue ich Auto-Reconnects für WebSocket ein?

Implementiere Heartbeats, zum Beispiel über regelmäßige Ping-Nachrichten, und eine Reconnect-Logik. Nach einem Disconnect sollte dein Client kurz warten, die Verbindung neu aufbauen und benötigte Channels erneut abonnieren. In der Praxis ist Exponential Backoff sinnvoll, damit du bei Serverproblemen keine Request-Flut erzeugst.

Q4: Wie sichere ich API-Trading-Funds ab?

Die Sicherheit hängt vor allem davon ab, wie du Private Keys schützt. Eine OneKey Hardware Wallet kann Signaturen erzeugen, ohne Private Keys auf einem verbundenen Gerät offenzulegen. Zusätzlich solltest du für API-Trading eigene Accounts verwenden, Positionslimits setzen und offene Orders sowie Positionen regelmäßig prüfen.

Q5: Unterstützt Hyperliquid Conditional Orders und Stop-Loss-Orders?

Hyperliquid unterstützt Trigger Orders, darunter Logiken für Stop-Loss und Take-Profit. Die genauen Parameter und Bedingungen solltest du in der offiziellen Dokumentation unter den Order Types prüfen. Komplexere Bedingungen kannst du alternativ auch auf Strategieebene umsetzen, indem du Positionen und Marktdaten laufend überwachst.

Fazit

Die Hyperliquid API bietet Entwicklern ein vollständiges und vergleichsweise gut strukturiertes Interface für On-Chain DEX-Trading. Info Endpoints eignen sich für Marktdaten, Analytics und Monitoring; Exchange Endpoints können zusammen mit WebSocket-Streams automatisierte Strategien von einfachen Copy-Trading-Ansätzen bis zu komplexeren Market-Making-Systemen unterstützen.

Der wichtigste Punkt bleibt Sicherheit. Das EIP-712-Signaturmodell macht Private-Key-Management zentral. OneKey kann dabei helfen, Keys hardwareseitig zu isolieren und Accounts sauber zu trennen. Für die praktische Nutzung ist OneKey Perps ein sinnvoller Workflow, um Perps-Positionen sicherer und übersichtlicher zu verwalten.

Wenn du mit Hyperliquid API-Entwicklung starten möchtest, lade OneKey herunter, richte einen dedizierten Trading-Account ein und teste OneKey Perps mit kleinen Positionen, bevor du automatisierte Strategien mit echtem Risiko skalierst.

Disclaimer: Dieser Artikel dient ausschließlich technischen Informationszwecken und stellt keine Anlage-, Finanz- oder Rechtsberatung dar. API-Trading birgt Automatisierungsrisiken; Fehler in Strategien oder Infrastruktur können zu unerwartet hohen Verlusten führen. Perpetual Contracts sind hochriskant und können durch Leverage besonders schnell zu Verlusten führen. Prüfe die technischen und marktbezogenen Risiken sorgfältig, bevor du handelst. Vergangene Strategieergebnisse sind kein Hinweis auf zukünftige Erträge.