Skip to main content
GET
Perps - Wallet Open Positions
  • Returns the currently open perpetual positions for one Hyperliquid wallet.
  • Position rows are live inventory entries, not historical executions.
  • Use this endpoint to inspect token-by-token exposure, leverage, liquidation price, size, margin, and unrealized performance.
  • This endpoint is wallet-centric; use token-centric position data when the market is your starting point instead of the trader.
  • This endpoint consumes 5 CU per request.
  • Inspect a trader’s live perp book token by token.
  • Build wallet risk dashboards showing leverage, liquidation sensitivity, and exposure concentration.
  • Analyze whether a trader is net long, net short, diversified, or highly concentrated.
  • Support trader due diligence, copy-trading research, and risk monitoring workflows.
  • Pass one Hyperliquid wallet address.
  • Read each row as one active perp position held by that wallet.
  • Combine with Perps Wallet Overview for summary context and Perps Token Overview for market-side context.
  • Use wallet overview first when you only need a quick trader snapshot.
  • Diff consecutive snapshots if you want to detect position changes, scaling, or rotation.
  • Cross-check liquidation prices against token-side liquidation-map context for better risk interpretation.

Authorizations

X-API-KEY
string
header
required

API key for authentication

Headers

x-perp
enum<string>
default:hyperliquid

Specify the perpetuals exchange. Currently supports hyperliquid.

Available options:
hyperliquid

Query Parameters

wallet
string
required

The address of the wallet.

Response

JSON object containing a list of open positions with certain fields

success
boolean
required

Whether the request succeeded.

data
object[]
required

Open perp positions currently held by the requested wallet.