Skip to main content
GET
/
2
/
wallet
/
positions
/
perp
/
open
Get wallet perp positions
curl --request GET \
  --url https://demo-api.mobula.io/api/2/wallet/positions/perp/open
{
  "data": [
    {
      "id": "<string>",
      "entryPriceQuote": 123,
      "currentLeverage": 123,
      "amountUSD": 123,
      "amountRaw": 123,
      "side": "BUY",
      "liquidationPriceQuote": 123,
      "currentPriceQuote": 123,
      "realizedPnlUSD": 123,
      "unrealizedPnlUSD": 123,
      "realizedPnlPercent": 123,
      "unrealizedPnlPercent": 123,
      "tp": [
        {
          "size": 123,
          "price": 123,
          "id": 123
        }
      ],
      "sl": [
        {
          "size": 123,
          "price": 123,
          "id": 123
        }
      ],
      "marketId": "<string>",
      "exchange": "gains",
      "feesOpeningUSD": 123,
      "feesClosingUSD": 123,
      "feesFundingUSD": 123,
      "openDate": "<string>",
      "lastUpdate": "<string>",
      "address": "<string>",
      "chainId": "<string>",
      "collateralAsset": "<string>"
    }
  ]
}

Query Parameters

wallet
string
required
The wallet address to query positions for.
chainId
string
Filter positions by chain ID (e.g. evm:42161). If omitted, returns positions from all supported chains.
dex
string
Filter positions by DEX. Supported values: gains, lighter. If omitted, returns positions from all supported DEXes.

Response

data
array
Array of open perpetual positions.

Query Parameters

wallet
string
required

Wallet address

blockchains
string

Comma-separated list of blockchain IDs (e.g., "ethereum,base,solana:solana"). If omitted, all chains.

limit
number

Number of positions per page (1-500, default: 100)

Required range: 1 <= x <= 500
offset
number | null

Offset for pagination (default: 0)

Required range: x >= 0
cursor
string

Cursor for cursor-based pagination (takes precedence over offset)

cursorDirection
enum<string>

Cursor direction (default: after)

Available options:
before,
after
sortBy
enum<string>

Sort field (default: lastActivity)

Available options:
lastActivity,
realizedPnl
order
enum<string>

Sort order (default: desc)

Available options:
asc,
desc

Response

200 - application/json

Wallet perp positions response

data
object[]
required