Perpetual Positions

Hyperliquid

Returns open perpetual positions using the current cross-margin response shape. It does not include spot balances or prediction-market outcome shares.

Endpoint

POST /info

Request Body

Parameter	Type	Description
`type`*	string	Must be `"positions"`
`user`*	string	User’s wallet address (case-insensitive), e.g., `"0x1234567890abcdef..."`

Response

200: Open Positions

[
  {
    "type": "oneWay",
    "position": {
      "coin": "BTC",
      "cumFunding": {
        "allTime": "0",
        "sinceChange": "0",
        "sinceOpen": "0"
      },
      "entryPx": "50000.00",
      "leverage": {
        "type": "cross",
        "value": 5
      },
      "liquidationPx": "45000.00",
      "marginUsed": "1000.00",
      "maxLeverage": 10,
      "positionValue": "5000.00",
      "returnOnEquity": "5.00",
      "szi": "0.1",
      "unrealizedPnl": "50.00",
      "hasTpsl": false
    }
  }
]

This REST serializer emits the cross-margin position set with leverage.type: "cross" and no isolated detail block. Account Summary over WebSocket includes isolated position rows. Use Market Trading State for an HTTP snapshot of one assigned HIP-3 market’s scope balances, leverage, health, and permissions.

Response item

Field	Type	Description
`type`	string	Position type; always `"oneWay"` in Notional
`position`	object	Position state

Position

Field	Type	Description
`coin`	string	Asset symbol, e.g., `"BTC"`
`cumFunding`	object	Cumulative funding payments
`entryPx`	string	Average entry price, e.g., `"50000.00"`
`leverage`	object	Leverage configuration
`liquidationPx`	string \| null	Estimated liquidation price, e.g., `"45000.00"`
`marginUsed`	string	Margin allocated to position, e.g., `"1000.00"`
`maxLeverage`	number	Maximum allowed leverage, e.g., `10`
`positionValue`	string	Notional value, e.g., `"5000.00"`
`returnOnEquity`	string	ROE percentage, e.g. `"5.00"` is 5%
`szi`	string	Signed size, e.g., `"0.1"` long or `"-0.1"` short
`unrealizedPnl`	string	Unrealized profit/loss, e.g., `"50.00"`
`hasTpsl`	boolean	Whether the position currently has TP/SL protection attached

Cumulative funding

Field	Type	Description
`allTime`	string	Cumulative funding for this user and market, retained across position closes
`sinceChange`	string	Funding since the latest size change, e.g., `"0"`
`sinceOpen`	string	Funding since the position opened, e.g., `"0"`

Funding amounts use Notional’s sign convention: positive means received, negative means paid.

Leverage

Field	Type	Description
`type`	`"cross"`	Margin mode; currently always `cross`
`value`	number	Current leverage, e.g., `5`

Start Here

Info

Analytics

Exchange

WebSocket

Endpoint

Request Body

Response

Response item

Position

Cumulative funding

Leverage

​Endpoint

​Request Body

​Response

​Response item

​Position

​Cumulative funding

​Leverage

Endpoint

Request Body

Response

Response item

Position

Cumulative funding

Leverage