Get positions

GET /positions

cURL

cURL

curl --request GET \
  --url https://api.jup.ag/perps/v1/positions \
  --header 'x-api-key: <api-key>'

200

{
  "dataList": [
    {
      "asset": "SOL",
      "assetMint": "So11111111111111111111111111111111111111112",
      "collateralToken": "SOL",
      "collateralMint": "So11111111111111111111111111111111111111112",
      "positionPubkey": "815wh1VLC8D7ZWMa3uB7GgjHFetANuML2dPrJiLV1nVF",
      "side": "long",
      "leverage": "21.30",
      "sizeUsd": "1234567800",
      "sizeTokenAmount": "250000000",
      "collateralUsd": "250000000",
      "valueUsd": "120000000",
      "entryPriceUsd": "123450000",
      "markPriceUsd": "125000000",
      "liquidationPriceUsd": "113450000",
      "openFeesUsd": "100000",
      "closeFeesUsd": "100000",
      "borrowFeesUsd": "100000",
      "totalFeesUsd": "200000",
      "pnlBeforeFeesUsd": "1045000",
      "pnlBeforeFeesPct": "20.24",
      "pnlAfterFeesUsd": "1045000",
      "pnlAfterFeesPct": "-20.24",
      "createdTime": 1722851463,
      "updatedTime": 1722851463,
      "tpslRequests": [
        {
          "positionRequestPubkey": "<string>",
          "requestType": "tp",
          "desiredMint": "So11111111111111111111111111111111111111112",
          "desiredToken": "SOL",
          "collateralUsdDelta": "1234000000",
          "entirePosition": true,
          "sizeUsd": "1234000000",
          "sizePercentage": "12.34",
          "triggerPriceUsd": "20000000",
          "openTime": "1722851463"
        }
      ]
    }
  ],
  "count": 123
}

Authorizations

x-api-key · string · header · required

Get API key via https://portal.jup.ag

Query Parameters

includeClosedPositions · boolean · default: false

Set to true to return closed positions

walletAddress · string · required

Public key for the wallet to fetch trades

Response

200

application/json

200 OK

dataList · object[] · required

Show child attributes

count · number · required