Sign in

v1

latestOpenAPI 3.1.02026-07-2359362475.0 KB
Profiler

Get Perpetual Positions Data

Get perpetual positions data for a user by calling the Hyperliquid API directly. This endpoint provides real-time position information including entry price, mark price, PnL, leverage, and other position details.

What it helps to answer:

  1. What are the current perpetual positions for a specific user address?
  2. What is the unrealized PnL and performance of each position?
  3. What are the leverage levels and margin requirements for each position?
  4. What are the liquidation prices and risk levels for each position?
post/api/v1/profiler/perp-positions

Request body

addressstring required

User's Hyperliquid address in 42-character hexadecimal format

Response

Perpetual positions data for the user