GET
/
v1
/
perps
/
hyperliquid
/
account
/
{address}
/
positions
Get Positions
curl --request GET \
  --url https://api.example.com/v1/perps/hyperliquid/account/{address}/positions

​
Upstream Mapping

Maps to Hyperliquid’s POST /info with { "type": "clearinghouseState", "user": "<address>" }, extracting the assetPositions array.

​
Request

​
address
string
required
Wallet address

​
Example

curl -H "X-API-Key: $API_KEY" \
  https://api.perps.studio/v1/perps/hyperliquid/account/0x1234.../positions
Example Response
[
  {
    "symbol": "BTC",
    "side": "long",
    "size": "0.50000",
    "entryPrice": "67000.00",
    "markPrice": "67542.10",
    "unrealizedPnl": "271.05",
    "leverage": "10",
    "liquidationPrice": "60500.00",
    "margin": "3350.00"
  }
]