Open Positions

Returns a wallet's open perpetual positions with its cross-margin summary and derived risk (leverage, unrealized PnL, ROE, liquidation price, margin ratio, distance-to-liquidation).

liquidation_price (and distance_to_liquidation) can be null even on a leveraged position — Hyperliquid returns none for cross positions whose spot collateral backstops them; in that case use the account-level margin_ratio (the account liquidates as it approaches 1.0) for proximity. account_value here is perp clearinghouse equity, not total portfolio (see /hyperliquid/account). Positions are sorted by position value (largest first). dex scopes to a builder market; omit (or main_dex) for the native market.