Get open perp positions

Get open perp positions

get

Fetch a wallet's open perpetual positions — asset, signed size (negative for a short), entry price, leverage, unrealized PnL and liquidation price.

This is where the size and is_buy for /api/v1/perp/close come from: read the position instead of tracking it yourself, since fills, funding and partial closes all move it. An empty list means the wallet holds no open positions.

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication

Query parameters

wallet_addressstringRequired

Wallet address on Hyperliquid

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

Responses

200

Successful Response

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

get/api/v1/perp/positions

HTTPcURLJavaScriptPython

GET /api/v1/perp/positions?wallet_address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Accept: */*

{
  "positions": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "ANY_ADDITIONAL_PROPERTY": "anything"
}