Die Hyperliquid-Plattform zeichnet sich als hochleistungsfähige dezentrale Börse für ewige Futures aus, die einen Handel mit geringer Latenz und erweiterte Funktionen für Entwickler bietet. Entwickler greifen häufig auf die Hyperliquid-API zurück, um Trades zu automatisieren, Märkte zu überwachen und benutzerdefinierte Anwendungen zu erstellen.
Sie beginnen damit, die Kernkomponenten der Hyperliquid-API zu verstehen. Die API gliedert sich in Schlüsselkategorien: die Info-API zum Abfragen von Marktdaten, die Exchange-API für Handelsaktionen und WebSocket für Echtzeit-Updates. Darüber hinaus vereinfachen SDKs in Sprachen wie Python und Node.js die Interaktionen. Im weiteren Verlauf werden Sie sehen, wie kleine Anpassungen in den Anfrageparametern zu erheblichen Verbesserungen der Ausführungseffizienz führen.
Was ist die Hyperliquid-API?
Die Hyperliquid-API ermöglicht den programmatischen Zugriff auf Hyperliquids dezentrale Perpetual-Börse. Sie unterstützt Operationen sowohl in Mainnet- als auch in Testnet-Umgebungen. Sie verbinden sich mit Mainnet und Testnet. Die API verwendet JSON für Anfragen und Antworten, wobei für die meisten Aktionen HTTP POST und für Abonnements WebSocket verwendet wird.
Sie authentifizieren sich in einigen Fällen mit privaten Schlüsseln anstelle traditioneller API-Schlüssel, aber Hyperliquid bietet auch API-Wallets für eine sichere Delegation an. Diese Wallets handeln im Namen Ihres Hauptkontos ohne Abhebungsberechtigungen, was die Sicherheit für den automatisierten Handel erhöht. Sie generieren beispielsweise eine API-Wallet über die Hyperliquid-App, autorisieren sie und verwenden ihren privaten Schlüssel in Ihren Skripten.
Betrachten Sie als Nächstes die Datentypen. Die API verwendet spezifische Strukturen und Enumerationen. Assets werden durch Indizes aus der Universumsliste identifiziert, Orderseiten verwenden Booleans (true für Kauf, false für Verkauf) und Time-in-Force-Optionen umfassen 'Gtc' für Good 'til canceled. Sie rufen diese Details von Metadaten-Endpunkten ab, um die Genauigkeit Ihrer Anfragen sicherzustellen.
Mit dieser Grundlage richten Sie Ihre Entwicklungsumgebung ein. Eine ordnungsgemäße Konfiguration verhindert häufige Fehler und beschleunigt die Iteration.
Einrichtung Ihrer Umgebung für die Hyperliquid-API
Sie beginnen die Einrichtung, indem Sie Ihre Programmiersprache auswählen und das entsprechende SDK installieren. Für Python-Benutzer bietet das hyperliquid-python-sdk einen robusten Ausgangspunkt. Installieren Sie es über pip mit dem Befehl pip install hyperliquid-python-sdk. Dieses SDK verwaltet Verbindungen, Authentifizierung und gängige Operationen.
Anschließend konfigurieren Sie Ihre Anmeldeinformationen. Erstellen Sie eine config.json-Datei mit Ihrer Kontoadresse (öffentlicher Schlüssel) und Ihrem geheimen Schlüssel (privater Schlüssel). Aus Sicherheitsgründen generieren Sie eine dedizierte API-Wallet. Navigieren Sie zur Hyperliquid-App, wählen Sie "Mehr > API", geben Sie einen Namen für den Schlüssel ein, fügen Sie Ihre Wallet-Adresse ein und klicken Sie auf "Generieren". Autorisieren Sie die API-Wallet und kopieren Sie ihren privaten Schlüssel in Ihre Konfiguration.
Das SDK importiert Konstanten für URLs, wie z.B. constants.TESTNET_API_URL für Tests. Sie initialisieren Clients wie folgt:
from hyperliquid.info import Info
from hyperliquid.utils import constants
info = Info(constants.TESTNET_API_URL, skip_ws=True)
Diese Einrichtung überspringt WebSocket zunächst und konzentriert sich auf HTTP. Sie testen die Verbindung, indem Sie den Benutzerstatus abfragen:
user_state = info.user_state("your_account_address")
print(user_state)
Wenn die Antwort Ihre Kontodaten anzeigt, funktioniert Ihre Umgebung korrekt. Wenn jedoch Fehler auftreten, überprüfen Sie Ihren privaten Schlüssel und die Netzwerkauswahl.
Für Node.js verwenden Sie das Paket @nktkas/hyperliquid. Installieren Sie es mit npm und richten Sie dann Transports und Clients mit ethers für die Wallet-Verwaltung ein. Sie geben isTestnet: true an, um während der Entwicklung keine echten Gelder zu verwenden.
Tools wie Apidog ergänzen diese Einrichtung. Sie importieren die Hyperliquid-API-Spezifikationen in Apidog, authentifizieren sich mit Ihren Schlüsseln und simulieren Anfragen. Dieser Ansatz zeigt schnell Antwortstrukturen auf und spart Zeit bei der manuellen Codierung.
Nach der Konfiguration gehen Sie zu den Authentifizierungsmethoden über. Eine ordnungsgemäße Authentifizierung stellt sicher, dass Ihre Aktionen sicher ausgeführt werden.
Authentifizierung mit der Hyperliquid-API
Sie authentifizieren sich hauptsächlich durch Signierung mit privatem Schlüssel, da Hyperliquid auf einem Blockchain-basierten System arbeitet. Die SDKs übernehmen die Signierung automatisch, wenn Sie eine Wallet-Instanz bereitstellen.
Für direkte API-Aufrufe ohne SDKs signieren Sie Payloads mit Ihrem privaten Schlüssel. Der Anfragetext enthält eine Nonce zum Schutz vor Replay-Angriffen, und Sie posten an die /exchange- oder /info-Endpunkte.
API-Wallets bieten zusätzliche Flexibilität. Sie erstellen eine, indem Sie ihr einen Namen geben, sie mit Ihrer Haupt-Wallet-Adresse verknüpfen, den Schlüssel generieren und autorisieren. Diese Wallet führt Trades aus, kann aber keine Gelder abheben, was das Risiko für Bots reduziert. Im Code verwenden Sie den privaten Schlüssel der API-Wallet und geben gleichzeitig die Hauptkontoadresse an.
Sie testen die Authentifizierung, indem Sie eine einfache Info-Anfrage senden. Wenn nicht autorisiert, gibt die API einen Fehler wie "Benutzer oder API-Wallet existiert nicht" zurück. Um dies zu beheben, stellen Sie sicher, dass Ihre Wallet eine Mindestsicherheit hält, wie z.B. USDC für Perpetual-Futures.
Sicherheit bleibt von größter Bedeutung. Sie speichern Schlüssel in Umgebungsvariablen oder sicheren Tresoren, rotieren sie regelmäßig und überwachen ungewöhnliche Aktivitäten. Mit eingerichteter Authentifizierung erkunden Sie die Info-API-Endpunkte.
Erkundung der Info-API-Endpunkte
Die Info-API bietet Lesezugriff auf Markt- und Kontodaten. Sie verwenden sie, um Metadaten, Preise, Orders und mehr abzurufen, ohne Authentifizierung für öffentliche Daten.
Sie beginnen mit dem Meta-Endpunkt, der das Asset-Universum und Kontexte zurückgibt. In Node.js:
const [meta] = await infoClient.metaAndAssetCtxs();
Dies liefert ein Array von Assets mit Namen, Indizes und Spezifikationen wie maximalem Hebel. Sie verwenden den Asset-Index in Handelsanfragen.
Als Nächstes fragen Sie Mittelpreise mit allMids ab, was die aktuellen Mittelpunkte für alle Paare zurückgibt. Offene Orders stammen von openOrders, wofür Ihre Adresse erforderlich ist.
Weitere Endpunkte umfassen:
- userState: Ruft Positionen, Margen und Salden ab.
- fundingHistory: Zeigt Finanzierungsraten über die Zeit an.
- l2Book: Bietet das Level-2-Orderbuch für eine Coin.
Sie senden POST-Anfragen mit JSON-Bodies wie {"type": "meta"} an /info. Antworten verwenden konsistente Strukturen, wobei "data" die Ergebnisse enthält.
Apidog hilft hier – Sie richten eine Sammlung für die Info-API ein, fügen Anfragen für jeden Typ hinzu und parametrisieren Coins oder Adressen. Diese Visualisierung hilft beim Verständnis des Datenflusses.
Während Sie Daten sammeln, gehen Sie zur Exchange-API über, um Trades auszuführen.
Verwendung der Exchange-API-Endpunkte für den Handel
Die Exchange-API verwaltet Aktionen wie Bestellen, Stornieren und Ändern. Sie authentifizieren alle Anfragen mit signierten Payloads.
Sie platzieren Orders, indem Sie Parameter definieren: Asset-Index, Seite, Preis, Größe, Reduce-Only-Flag und Typ (Limit oder Markt). Für einen Limit-Verkauf:
In Elixir (aus den SDK-Dokumenten):
Hyperliquid.Api.Exchange.place_order(order)
Wobei order eine Map ist mit a: Asset, b: false (verkaufen), p: "100", s: "0.1", r: false, t: {limit: {tif: "Gtc"}}.
Die Antwort enthält Status und Order-ID bei Erfolg.
Sie stornieren Orders mit Asset und oid (Order-ID):
Hyperliquid.Api.Exchange.cancel_order(asset, oid)
Für Batches verwenden Sie cancel_orders mit einer Liste.
Änderungen erfolgen ähnlich: oid und neue Parameter angeben.
Weitere Aktionen umfassen das Aktualisieren des Hebels:
Hyperliquid.Api.Exchange.update_leverage(asset, is_cross, leverage)
Und Transfers, wie spot_perp_transfer zum Verschieben von Geldern zwischen Konten.
Sie behandeln Fehler, indem Sie den Antwortstatus überprüfen – "ok" für Erfolg, ansonsten Details wie unzureichende Marge.
Beispiele zeigen die praktische Anwendung. Sie erstellen beispielsweise einen Bot, der eine Kauforder platziert, wenn der Preis unter einen Schwellenwert fällt, wobei Info für Preisprüfungen und Exchange für die Platzierung verwendet wird.
Darüber hinaus integrieren Sie WebSocket für Echtzeit-Updates, um die Reaktionsfähigkeit zu verbessern.
Integration von WebSocket für Echtzeitdaten
Sie verbinden sich mit WebSocket für Live-Streams. Verwenden Sie wss://api.hyperliquid.xyz/ws für Mainnet oder das Testnet-Äquivalent.
Sie abonnieren, indem Sie JSON senden: {"method": "subscribe", "subscription": {"type": "trades", "coin": "SOL"}}.
Der Server antwortet mit einer Bestätigung und pusht dann Updates wie neue Trades.
Sie verwalten Themen wie Orderbuch, Benutzerereignisse und Benachrichtigungen. Im Python SDK setzen Sie skip_ws=False, um es zu aktivieren.
Diese Echtzeit-Fähigkeit ermöglicht es Ihnen, sofort auf Marktänderungen zu reagieren, wie z.B. das Anpassen von Orders bei Ausführungen.
Nachdem die Endpunkte behandelt wurden, untersuchen Sie das Python SDK detailliert.
Nutzung des Hyperliquid Python SDK
Das Python SDK abstrahiert API-Aufrufe in Klassen. Sie importieren Info für Abfragen und Exchange für Aktionen.
Sie platzieren eine grundlegende Order wie folgt (aus Beispielen):
Zuerst Konfiguration laden:
import json
def address_and_private_key():
with open("examples/config.json") as f:
config = json.load(f)
return config["account_address"], config["secret_key"]
Dann Exchange initialisieren:
from hyperliquid.exchange import Exchange
from hyperliquid.utils import constants
address, private = address_and_private_key()
exchange = Exchange(address, private, base_url=constants.TESTNET_API_URL)
Order platzieren:
order_result = exchange.order("BTC", True, 0.02, 30000, {"limit": {"tif": "Gtc"}})
print(order_result)
Dies kauft 0,02 BTC zum Limit von 30.000 $.
Sie erweitern dies für erweiterte Funktionen, wie Batch-Orders oder Stornierungen.
Das SDK unterstützt auch Vault-Adressen für verwaltete Konten.
Beispiele im Repository decken basic_order, user_state und mehr ab und zeigen vollständige Workflows.
Während Sie entwickeln, integrieren Sie Best Practices zur Leistungsoptimierung.
Best Practices für die Nutzung der Hyperliquid-API
Sie überwachen Ratenbegrenzungen, um Drosselung zu vermeiden – Hyperliquid erzwingt Limits pro IP und pro Konto.
Verwenden Sie das Testnet für die gesamte Entwicklung, um finanzielle Verluste zu vermeiden.
Fehlerbehandlung beinhaltet das Protokollieren von Details und das Wiederholen vorübergehender Fehler mit Backoff.
Für Skalierbarkeit bündeln Sie Anfragen, wo immer möglich, wie z.B. mehrere Stornierungen.
Sicherheit erstreckt sich auf die Verwendung von API-Wallets und dem Prinzip der geringsten Berechtigung.
Sie versionieren Ihren Code auch mit SDK-Updates, da Hyperliquid semantischer Versionierung folgt.
Tools wie Apidog unterstützen beim Mocking von Antworten für Unit-Tests.
Fehlerbehebung folgt, wenn Probleme auftreten.
Fehlerbehebung bei häufigen Hyperliquid-API-Problemen
Sie stoßen auf "Ungenügende Marge", wenn die Sicherheit gering ist – zahlen Sie USDC ein, um dies zu beheben.
Wenn "Asset nicht gefunden", überprüfen Sie die Indizes aus Meta.
Authentifizierungsfehler resultieren aus ungültigen Schlüsseln – generieren und autorisieren Sie API-Wallets neu.
Netzwerkprobleme erfordern die Überprüfung von URLs und gegebenenfalls die Verwendung von Proxys.
Sie debuggen mit Apidog, indem Sie fehlgeschlagene Anfragen wiederholen.
Protokolle von SDKs liefern Zeitstempel und Payloads zur Analyse.
Mit diesen Tipps pflegen Sie zuverlässige Integrationen.
Fortgeschrittene Anwendungsfälle mit der Hyperliquid-API
Sie erstellen Trading-Bots, die l2Book überwachen und Orders bei Ungleichgewichten platzieren.
Strategien umfassen Finanzierungsraten aus der Historie für Arbitrage-Möglichkeiten.
Unterkonten ermöglichen getrennten Handel: mit Namen erstellen, Gelder überweisen und separat handeln.
Vault-Transfers unterstützen gemeinsame Liquiditätspools.
Sie simulieren mit historischen Daten von der API, um Backtests durchzuführen.
Integration mit Apidog ermöglicht kollaboratives Debugging in Teams.
Zum Abschluss betrachten Sie zukünftige Verbesserungen.
Fazit: Die Hyperliquid-API für dezentralen Handel meistern
Sie verfügen nun über das Wissen, um die Hyperliquid-API effektiv zu nutzen. Von der Einrichtung und Authentifizierung bis hin zu Endpunkten und SDKs rüstet Sie dieser Leitfaden für den Bau anspruchsvoller Anwendungen aus. Denken Sie daran, dass inkrementelle Verfeinerungen in Ihrem Code zu erheblichen Leistungssteigerungen führen. Experimentieren Sie im Testnet, nutzen Sie Tools wie Apidog und bleiben Sie mit den Hyperliquid-Dokumenten auf dem Laufenden. Während sich die Plattform weiterentwickelt, positionieren Ihre Fähigkeiten Sie, um neue Funktionen zu nutzen.