Diese Seite ist eine Community-Übersetzung und dient nur zur Orientierung; maßgeblich ist die englische Originalversion.
Englisches Original ↗

Fehlerantworten

Fehler bei Orders und Stornierungen werden üblicherweise als Vektor mit derselben Länge wie die gebündelte Anfrage zurückgegeben.

Nachfolgend finden Sie eine Liste möglicher Fehlerantworten auf gebündelte Anfragen:

Error source Error type Error string
Order Tick Price must be divisible by tick size.
Order MinTradeNtl Order must have minimum value of $10.
Order MinTradeSpotNtl Order must have minimum value of 10 {quote_token}.
Order PerpMargin Insufficient margin to place order.
Order ReduceOnly Reduce only order would increase position.
Order BadAloPx Post only order would have immediately matched, bbo was {bbo}.
Order IocCancel Order could not immediately match against any resting orders.
Order BadTriggerPx Invalid TP/SL price.
Order MarketOrderNoLiquidity No liquidity available for market order.
Order PositionIncreaseAtOpenInterestCap Order would increase open interest while open interest is capped
Order PositionFlipAtOpenInterestCap Order would increase open interest while open interest is capped
Order TooAggressiveAtOpenInterestCap Order rejected due to price more aggressive than oracle while at open interest cap
Order OpenInterestIncrease Order would increase open interest too quickly
Order InsufficientSpotBalance (Spot-only) Order has insufficient spot balance to trade
Order Oracle Order price too far from oracle
Order PerpMaxPosition Order would cause position to exceed margin tier limit at current leverage
Cancel MissingOrder Order was never placed, already canceled, or filled.

Wichtig: Einige Fehler sind eine deterministische Funktion des Payloads selbst und werden stattdessen bereits bei der Vorvalidierung zurückgegeben. In diesem Fall wird für den gesamten Payload nur ein einziger Fehler zurückgegeben, da einige dieser Fehler nicht auf eine bestimmte Order oder Stornierung zutreffen.

Beispiele hierfür sind: ein leerer Batch von Orders, TP/SL-Orders ohne Reduce-Only, eine zu weit vom Referenzpreis entfernte Order und einige Formen der Tick-Size-Validierung.

Für API-Nutzer, die Batching verwenden, wird empfohlen, den Fall zu behandeln, in dem für einen Batch mit mehreren Orders ein einziger Fehler zurückgegeben wird. In diesem Fall kann die Antwort nmal dupliziert werden, bevor sie an die Callback-Funktion gesendet wird, da der gesamte Batch aus diesem Grund abgelehnt wurde.

Für API-Nutzer, die historische Orders verwenden, findet sich hier eine Liste aller historischen Order-Statuswerte für Stornierungen und Ablehnungen.

Inoffizielle Community-Übersetzung der Hyperliquid-Dokumentation. Inhalte © Hyperliquid; maßgeblich ist die englische Version. Quelle: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/error-responses