Skip to main content
GET
/
2
/
wallet
/
positions
/
perp
/
unfilled
Get unfilled perp orders
curl --request GET \
  --url https://demo-api.mobula.io/api/2/wallet/positions/perp/unfilled
{
  "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>",
      "type": "STOP"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.mobula.io/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

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

Response

data
array
Array of unfilled perpetual orders.

Query Parameters

wallet
string
required

Wallet address

chainIds
string

Comma-separated list of chain IDs (e.g., "evm:1,evm:8453,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
includeFees
required

Include fees in PnL calculation (deduct total_fees_paid_usd from PnL)

useSwapRecipient
required

Use swap recipient mode (query wallet_positions_recipients table instead of wallet_positions)

includeAllBalances
required

Include all tokens the wallet holds, not just tokens with trading history

Response

200 - application/json

Unfilled perp orders response

data
object[]
required