Skip to main content
GET
Perps - Token Open Positions
  • Returns the open perpetual positions currently held in one Hyperliquid token market.
  • Position rows are participant-level inventory, not executed trade history.
  • Use this endpoint when you need wallet exposure, leverage, margin, size, entry price, mark price, or unrealized PnL per position.
  • Large active markets can produce heavier result sets than overview endpoints.
  • This endpoint consumes 10 CU per request.
  • Inspect who is carrying long and short exposure in a perp market right now.
  • Build exposure ladders, leverage monitors, and wallet-level risk dashboards.
  • Analyze how concentrated open interest is across market participants.
  • Investigate crowded positioning before volatility events or liquidation cascades.
  • Query one Hyperliquid perp token market.
  • Read each returned row as a current open position with wallet, sizing, pricing, leverage, margin, and PnL context.
  • Combine with Perps Token Overview for market summary and Perps Wallet Open Positions for wallet-centric follow-up.
  • Use this endpoint only when you genuinely need position granularity; overview is cheaper for top-line monitoring.
  • Compare position concentration with liquidation-map data to identify crowded risk zones.
  • Keep position snapshots timestamped in your system if you plan to diff changes over time.

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

token
string
required

The symbol of a coin/token (e.g: BTC, SOL, ETH).

sort_by
enum<string>
default:open_time
Available options:
position_value,
open_time
sort_type
enum<string>
default:desc

Specify the sort order.

Available options:
desc,
asc
offset
integer
default:0

Specify the offset for pagination. Filter for records with offset greater than the specified offset value, including those with offset equal to the specified offset.

limit
integer
default:10

Number of items per page.

Required range: 1 <= x <= 50

Response

JSON object containing a list of open positions with certain fields

success
boolean
required

Whether the request succeeded.

data
object[]
required

Open positions for the requested token market.