v2

latestOpenAPI 3.1.02026-07-316132736.5 KB
V2 - Perps

Get unfilled perp orders

Retrieve all open (unfilled) limit or stop orders for a specific wallet.

get/api/2/wallet/positions/perp/unfilled

Query parameters

walletstring required

Wallet address

Wallet address

chainIdsstring

Comma-separated list of chain IDs (e.g., "evm:1,evm:8453,solana:solana"). If omitted, all chains.

Comma-separated list of chain IDs (e.g., "evm:1,evm:8453,solana:solana"). If omitted, all chains.

limitnumber

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

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

offsetnumber nullable

Offset for pagination (default: 0)

Offset for pagination (default: 0)

cursorstring

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

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

cursorDirection'before' | 'after'

Cursor direction (default: after)

Cursor direction (default: after)

sortBy'lastActivity' | 'realizedPnl'

Sort field (default: lastActivity)

Sort field (default: lastActivity)

order'asc' | 'desc'

Sort order (default: desc)

Sort order (default: desc)

boolean required
OR
string required

Include fees in PnL calculation (deduct total_fees_paid_usd from PnL)

boolean required
OR
string required

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

boolean required
OR
string required

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

boolean required
OR
string required

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

minPositionValueUSDnumber nullable

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

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

Response

Unfilled perp orders response