Skip to main content
GET
Get wallet perp positions

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)

includeAllBalances
required

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

onlyOpen
required

Return only positions still held on-chain (filters out fully closed positions)

minPositionValueUSD
number | null

Drop positions worth less than this USD value (live RPC balance × live pool price)

Required range: x >= 0

Response

200 - application/json

Wallet perp positions response

data
object[]
required